Documentation
Published documentation pages covering reference material for the CLI surface, including contracts, conventions, and supporting detail.
- API
Reach and use the you-agent-factory local HTTP API: default base URL, factory-running precondition, session-oriented flow, and the path to the operations catalog.
- Architecture of system
How you-agent-factory is structured: factory topology, work, workstations, workers, resources, and live FactorySession runtime.
- CLI
Install the you-agent-factory CLI and look up the core you commands for starting a factory, submitting work, checking sessions, and reading packaged docs.
- Contributing to these docs
How to add factory documentation pages to the you-agent-factory docs site without recreating retired product patterns.
- Dashboard / UI Overview
Overview of the you-agent-factory local operator dashboard for live Factory Session inspection and control visibility—not a rebuilt in-docs dashboard product.
- Dynamic Workflows
A dynamic workflow is a JavaScript orchestrator-backed factory whose live run is a Factory Session—not a separate runtime type.
- Factory Sessions
A Factory Session is the live runtime unit on a running you-agent-factory host—what you discover, inspect, pause or resume, and address when submitting work.
- FAQ
Short answers to common you-agent-factory questions that point at the owning canonical docs for install, run, configuration, MCP, and dynamic workflows.
- Harness Support
Compare you-agent-factory harness support across claude, codex, opencode, pi, cursor, and agy for Model Context Protocol (MCP), worktrees, loop, thinking controls, open source, and external models.
- Install you-agent-factory
Install teaching for you-agent-factory lives in Getting Started. Continue there for OS install scripts, confirm-you guidance, and starter scaffold.
- Logs
Find you-agent-factory runtime logs under the selected log root, manage rolling retention, and use CLI --verbose / --debug diagnostics without confusing logs with metrics or record/replay.
- MCP
Connect an MCP-capable host to you-agent-factory with you mcp serve over stdio, host JSON configuration, serve modes, and Factory Session tools.
- Metrics
Watch live you-agent-factory factory-ops metrics for a Factory Session: engine activity, work-token lifecycle, optional resource usage, and the local operator dashboard.
- Packaged documents
Packaged markdown reference topics printed from the installed you-agent-factory CLI via you docs.
- Packaged Factories
Packaged factories are catalog-backed @you/* built-ins you discover and run by canonical name with you run --named—not the same as Packaged documents (you docs topics).
- Petri / Colored Petri Net (CPN)
How you-agent-factory maps factory topology onto a Petri / Colored Petri Net (CPN) execution model: places, colored tokens, transitions, and markings.
- Replays / Records
Capture a live you-agent-factory run as a replay artifact, find the saved recording after shutdown, or re-run from saved history without dispatching live workers again.
- Resources
Declare bounded-concurrency resource pools in factory.json and consume them from workstation requirements while a dispatch is in flight.
- Security / Trust Boundaries
Current you-agent-factory trust boundaries for the local factory service, operator surfaces, and sensitive artifacts—not a compliance certification claim.
- Submitting Work
Submit work batches to a running you-agent-factory and relate work items with DEPENDS_ON or PARENT_CHILD.
- Throttling and limits
Distinguish you-agent-factory resource capacity, provider limits, queue pressure, and retry/limit behavior without inventing a global throttle guarantee.
- Troubleshooting
Recover from you-agent-factory install, run, configuration, MCP, and dynamic-workflow failures with short symptom-scoped guidance that links to the owning canonical docs.
- What is you-agent-factory
you-agent-factory is a CLI and agent-factory workflow system that keeps long-running agent work persistent.