Full Mode¶

Overview¶

The --full flag runs an exhaustive analysis with no size limits. It was introduced in v7.0.0 for cases where complete coverage matters more than speed.

• Standard mode (default): Selective analysis with graceful degradation on tool errors
• Full mode: Exhaustive analysis, all dependencies looked up via context7, fail-fast on errors

flowchart LR
    A[code-context-agent analyze] --> B{--full?}
    B -- No --> C[Standard Mode]
    B -- Yes --> D[Full Mode]
    C --> C1[Selective analysis]
    C --> C2[Graceful degradation]
    C --> C3[Key dependencies]
    D --> D1[Exhaustive analysis]
    D --> D2[ALL dependencies via context7]
    D --> D3[Fail-fast errors]

Usage¶

# Exhaustive analysis of a repository
code-context-agent analyze /path/to/repo --full

# Full mode with a focus area
code-context-agent analyze . --full --focus "authentication"

What Changes in Full Mode¶

Fail-Fast Error Handling¶

In full mode, the FailFastHook monitors every tool invocation. When a non-exempt tool returns an error, the hook raises FullModeToolError and halts the analysis immediately.

This prevents silently degraded results -- you get all signals or a clear failure.

Exempt tools¶

The following tools are allowed to fail without triggering a halt:

All other tool errors are treated as fatal in full mode.

Additional Output¶

Full mode uses the same output structure as standard mode (CONTEXT.md, bundles/BUNDLE.{area}.md, etc.) but with extended analysis depth, more teams dispatched, and all dependencies looked up via context7. The increased turn and duration limits allow the coordinator to dispatch more investigation teams and produce richer bundle content.

All files are written to .code-context/ (or your custom --output-dir).

Configuration¶

Full mode overrides the standard duration and turn limits. These can be tuned via environment variables:

# Example: allow up to 2 hours for a very large codebase
export CODE_CONTEXT_FULL_MAX_DURATION=7200
export CODE_CONTEXT_FULL_MAX_TURNS=5000
code-context-agent analyze /path/to/monorepo --full

Flag Combinations¶

--full can be combined with some flags but not others:

The --since flag produces a delta analysis (changes since a ref), which is fundamentally incompatible with the exhaustive nature of full mode.

When to Use Full Mode¶