# Fractal

> Build your own software factory. Fractal is an open framework for coordinating agents and tools.

## Documentation

- [Introduction](https://fractal.how/docs.md): Build your own software factory with Fractal.
- [Understand Fractal](https://fractal.how/docs/concepts.md): The building blocks that turn goals into durable, verifiable agent work.
- [The software factory](https://fractal.how/docs/concepts/software-factory.md): How goals become coordinated work, verified results, and useful human decisions.
- [Agents](https://fractal.how/docs/concepts/agents.md): A durable harness, model, and workspace that can serve many missions.
- [Missions and runs](https://fractal.how/docs/concepts/missions.md): Separate the declared definition of work from each execution.
- [Steps and work](https://fractal.how/docs/concepts/steps.md): Use dependencies and explicit ownership to coordinate units of work.
- [Products and gates](https://fractal.how/docs/concepts/gates.md): Declare the evidence and decisions that make work complete.
- [The graph](https://fractal.how/docs/concepts/graph.md): Durable claims preserve intent, observations, and decisions across process lifetimes.
- [Attention](https://fractal.how/docs/concepts/attention.md): Find the decisions and requests that need you without watching every agent.
- [From intent to mission](https://fractal.how/docs/concepts/launch.md): Draft, preview, and approve a mission from a plain-language request.
- [Getting started](https://fractal.how/docs/getting-started.md): Choose a setup path and run your first agent and mission.
- [Install Fractal](https://fractal.how/docs/getting-started/install.md): Install the CLI, configure your identity, and start the daemon.
- [Set up with your agent](https://fractal.how/docs/getting-started/with-your-agent.md): An unattended procedure for installing Fractal and running a first mission.
- [Your first agent](https://fractal.how/docs/getting-started/first-agent.md): Declare a durable worker with a harness and a workspace.
- [Your first mission](https://fractal.how/docs/getting-started/first-mission.md): Publish a finite goal, start a run, and inspect the result.
- [Guides](https://fractal.how/docs/guides.md): Practical workflows for running and operating your software factory.
- [Missions in practice](https://fractal.how/docs/guides/missions-in-practice.md): Add dependencies, human review, queued runs, and explicit revisions.
- [Talking to agents](https://fractal.how/docs/guides/talking-to-agents.md): Send durable messages and distinguish conversation from tracked work and decisions.
- [Agent lifecycle](https://fractal.how/docs/guides/agent-lifecycle.md): Choose restart, stop, or suspend without confusing durable work with native sessions.
- [Connect two machines](https://fractal.how/docs/guides/two-machines.md): Join your own machines into a fleet and verify graph replication.
- [Fleet membership](https://fractal.how/docs/guides/fleet-join.md): Understand invitations, member trust, and safe removal.
- [Upgrade Fractal safely](https://fractal.how/docs/guides/upgrading.md): Read upgrade impact, preserve recoverable state, and compare client and daemon builds.
- [When something is wrong](https://fractal.how/docs/guides/troubleshooting.md): Diagnose the smallest failing boundary while preserving state and useful evidence.
- [GitHub integration](https://fractal.how/docs/guides/github-integration.md): Turn repository events into finite, evidence-backed agent work.
- [Web and iOS clients](https://fractal.how/docs/guides/web-and-ios.md): Open an existing web app or pair an iOS client to follow your agents.
- [Build and run the iOS app](https://fractal.how/docs/guides/ios-app.md): Build a local iPhone or simulator client and pair it to your daemon.
- [Scripted demo files](https://fractal.how/docs/guides/demos.md): Inspect repeatable invented-data fixtures without starting agents or spending model tokens.
- [Reference](https://fractal.how/docs/reference.md): Command, declaration, installation, and client contracts.
- [CLI reference](https://fractal.how/docs/reference/cli.md): Find the right Fractal command and inspect its exact options.
- [Configuration and KDL](https://fractal.how/docs/reference/configuration.md): Understand local configuration, atomic declaration publication, and explicit run revision.
- [Home Manager](https://fractal.how/docs/reference/home-manager.md): Let one declarative configuration own installation and the user daemon.
- [Client API](https://fractal.how/docs/reference/client-api.md): Use the supported client contract rather than the privileged daemon surface.

The complete documentation is available at https://fractal.how/llms-full.txt.