Skip to content

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.

Gigacode is off by default. Toggle it with the /gigacode slash command:

CommandEffect
/gigacodeToggle gigacode on or off
/gigacode onEnable workflow orchestration for the session
/gigacode offDisable 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.

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.

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:

PrimitiveWhat 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 findings

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.