code-factory.mp4
Code Factory brings requirements, coding agents, and GitHub pull requests into one control plane, accessible through the Web dashboard or human CLI (code-factory-human-cli). Organize work as a requirement tree and collaborate with Codex, Claude Code, or Native Agent through conversation.
Each requirement has its own persistent agent context. Jev stops automatic recovery after two consecutive failed or timed-out RD Runs; a successful Run starts a fresh failure streak. Agents can split work into child requirements and work in parallel, while humans steer the work, request reviews, and confirm completion.
Native Agents using E2B can check, pause, and resume their selected sandbox and transfer files between the host and sandbox, including conversation attachments. Pausing preserves remote state while the Agent continues on the host.
Codex, Claude Code, and Native RD Agents can explicitly publish generated files as conversation attachments. Remote browser users can download them from the conversation; file bytes stay outside model context during publication. Human uploads and Agent-published attachments are reclaimed after 7 days by default; change the retention period in Settings without restarting. Message text remains available.
Requirement details include collapsible tool calls with arguments, results, and execution status, plus a live working indicator. Both follow the dashboard's light/dark theme and English/Simplified Chinese language setting.
Use the top-right Open conversation in a new page control in a requirement's conversation to continue in a separate browser tab with the full page available. The page keeps the same requirement and Manager connection when refreshed.
Standalone conversations use a centered column with space on both sides on wide screens. The column and side gutters share the same background in both themes. Requirement details scroll away with the history; Back to top brings them back, while the reply composer stays available below.
Local workspaces support Codex, Claude Code, and Native Agent; E2B workspaces support Native Agent. Each requirement keeps one persistent RD session, and its on-demand Reviewer uses the same selected workspace.
Requires Node.js 22.19+. See Running Code Factory for agent CLI and GitHub setup, or the Native Agent guide for API profile configuration.
cd /path/to/the/repository/to-manage
npx --package @luoyixin/code-factory code-factory-agent-manager start --daemonOpen http://127.0.0.1:4310, create a requirement, and select an agent to begin. The startup directory becomes the default workspace; the dashboard is bundled with Agent Manager.
Unsent conversation text and attachments return when you reopen a requirement or reload the dashboard in the same browser.
For human-directed terminal management, use npx --package @luoyixin/code-factory code-factory-human-cli --help. The CLI and companion skill support search, requirement inspection, human replies, lifecycle actions, PR reviews, and timers. See CLI usage.
E2B sandbox creation defaults to the e2b.app domain when left blank and connects an execution environment without preparing a repository; the Native Agent chooses and clones the task repository when needed. Optional sandbox environment variables supply tokens and build settings to Native Agent commands. You can edit them during a Run; the next RD or Reviewer command uses the latest values, while running commands and background processes need a restart. See the Native Agent guide.
Headless agents inherit your filesystem, network, and command permissions. Run Code Factory in trusted repositories and limit dashboard access to trusted users.
- Running Code Factory — prerequisites, configuration, CLI options, and daemon operation.
- Tailscale remote access — access the dashboard from another device.
- Architecture and domain model — requirement lifecycle, sessions, messaging, and review workflow.
- Headless Agent Runner — Codex and Claude Code integration.
- Native Agent guide — API profiles, tools, and E2B sandboxes.
- E2B lifecycle and readiness audit — current lifecycle, control ownership, and capability gaps.
- HTTP API reference and event protocol.
- Development guide — source installation, builds, and checks.
- Release guide and roadmap.