Code Agent
Implementation specialist that reads triaged GitHub issues, implements fixes or features following repository conventions, runs tests and linters, and commits to a local feature branch.
How the agent works
Triggered when the ready-to-code label is applied to an issue or via /fs-code.
The code agent follows a three-phase pipeline: pre-script, sandbox execution, post-script.
- Pre-script validates inputs on the runner before sandbox creation. It also checks for open PRs linked to the issue.
- Sandbox — the agent reads the issue, explores the codebase, writes code, runs tests and linters, and commits locally. It has no network access (enforced by OpenShell).
- Post-script runs on the runner: it performs protected path checks, secret scanning, pre-commit checks, pushes the branch, and creates the PR.
This separation ensures the agent never has direct write access to the repository.
How it helps
- Triaged issues can go from "ready" to "PR open" without human involvement.
- Implementation follows repo conventions because the agent reads existing code, tests, and linter configs before writing.
- The sandboxed execution model means a misbehaving agent cannot push arbitrary code — the post-script gates everything.
Commands
| Command | Where | Effect |
|---|---|---|
/fs-code | Issue comment | Triggers the code agent on the issue |
Requires write-level repository permission (admin, maintain, or write).
The /fs-code command accepts an optional --force flag. It can only be used on issues (not PRs). The code agent is also triggered automatically when the ready-to-code label is applied to an issue.
Control labels
| Label | Meaning |
|---|---|
ready-to-code | Triggers the code agent. Applied by the triage post-script for low-risk categories (bug, documentation, performance), or manually by a human for feature work after prioritization. |
ready-for-review | Applied by the code agent's post-script after pushing a PR. In per-repo installs, triggers review when applied to a PR; also marks workflow state for humans and the retro agent. |
Configuration and extension
See Customizing with AGENTS.md and Customizing with Skills.
Variables
None.