Gigacode
Gigacode lets the agent take on work that’s too big for a single pass by orchestrating many sub-agents at once. When it’s enabled and a task calls for it, the agent writes a small workflow that fans sub-agents out in parallel, pipelines them, or loops over them — then collects the results.
It’s built for work that’s wide rather than deep:
- Broad audits and multi-file reviews.
- Large migrations or mechanical changes spread across many files.
- Judge panels and adversarial verification, where several agents cross-check each other.
- Implementing a plan whose parts are independent, in parallel.
For a quick question or a small, focused edit, the agent just does it directly — gigacode is for genuine fan-out.
Turning it on
Section titled “Turning it on”Gigacode is off by default. Toggle it with the /gigacode
slash command:
| Command | Effect |
|---|---|
/gigacode | Toggle gigacode on or off |
/gigacode on | Enable workflow orchestration for the session |
/gigacode off | Disable it |
Once on, it stays on for the session, and the agent decides when a task is worth orchestrating. It works in both Build and Plan modes — see Behavior and safety for how each differs.
What you’ll see
Section titled “What you’ll see”When the agent runs a workflow, the transcript shows phase headers and short
progress lines as it works. Each sub-agent it launches appears in the
sub-agent inspector — press Ctrl+G to
watch every agent’s live trajectory, grouped by phase.
How it works
Section titled “How it works”Under the hood, the agent authors a short Python script and runs it with a
single run_workflow tool call. The script uses a handful of primitives:
| Primitive | What it does |
|---|---|
agent(...) | Dispatch one sub-agent and get its result back |
parallel([...]) | Run several sub-agents at once and wait for all of them |
pipeline(items, ...) | Run each item through a series of stages independently |
phase(...) / log(...) | Report progress to the UI |
You don’t write these scripts — the agent does. A sketch of what it generates:
# Review three areas in parallel, then synthesize.phase("Review")findings = await parallel([ (lambda area=area: agent(f"Review the {area} module for bugs")) for area in ["auth", "api", "cli"]])return findingsBehavior and safety
Section titled “Behavior and safety”How workflow sub-agents behave depends on the mode you’re in.
Plan mode — every workflow sub-agent is read-only (an investigation agent), no matter what the workflow asks for. Use it to fan out parallel research and synthesis while planning; it never edits your code.
Build mode — sub-agents have the full toolset and can edit files and run commands.
A few more guarantees:
- Workflow sub-agents don’t touch your task list — only the main agent manages it, so agents running in parallel can’t clobber it.
- Concurrency is capped, and there’s a hard ceiling on the total number of agents a single workflow can spawn, as a runaway-loop backstop.
See also
Section titled “See also”- Build & Plan Modes — how modes shape what agents can do.
- Agents — the sub-agent types a workflow draws on.
- Slash Commands — the full command reference.
- Interface Tour — the sub-agent inspector.