> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildwithtrace.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Roadmap

> What's shipped in the Trace CLI today, the documented gaps we're closing, and where it's headed.

<Info>
  This roadmap is reconciled against the shipping code. The **Shipped** list is what actually works in `v0.1.0` today. The **Closing the doc↔code gap** section tracks behavior that the docs, README, or a command's help imply but the code doesn't do yet — we track these explicitly so the docs never describe something that isn't real.
</Info>

## Shipped — v0.1.0 (May 2026)

<CardGroup cols={2}>
  <Card title="AI design" icon="robot">
    `chat`, `ask`, `agent`, `plan`, `review`, `signal`
  </Card>

  <Card title="Local validation & export" icon="circle-check">
    `erc`, `drc`, `gerbers`, `export` (pdf/svg/netlist/bom/step/pos), `engine`
  </Card>

  <Card title="Conversion" icon="arrows-rotate">
    `convert` (Altium ↔ KiCad ↔ `.trace_sch`/`.trace_pcb`), netlist-accurate Altium import
  </Card>

  <Card title="Offline helpers" icon="magnifying-glass">
    `index`, `rules`, `history`
  </Card>

  <Card title="Parts & manufacturing" icon="industry">
    `components`, `bom`, `generate`, `dfm`, `order` (status/list/checkout/cancel/freight)
  </Card>

  <Card title="Account & teams" icon="users">
    `auth`, `whoami`, `versions`, `teams`, `billing`, `share`
  </Card>

  <Card title="Integration" icon="plug">
    `byok`, `mcp` (12 tools + 4 prompts), `altium` bridge, `config`, `doctor`
  </Card>

  <Card title="Distribution" icon="box">
    pip, Homebrew, npm, GitHub Action, Python SDK (`buildwithtrace-sdk`), Node SDK (`@buildwithtrace/sdk`) — both standalone agents
  </Card>
</CardGroup>

## Closing the doc↔code gap

These are referenced in the README, the docs, or a command's help/flags, but aren't fully implemented yet. They're the highest priority because shipped docs should never describe behavior that doesn't exist.

| Gap                                                                                    | Status today                               | Target          |
| -------------------------------------------------------------------------------------- | ------------------------------------------ | --------------- |
| `order submit`                                                                         | Stub — prints guidance, no real submission | v0.2.0          |
| `versions diff`                                                                        | Not built (README implied "diff")          | v0.2.0          |
| `teams switch` + member management                                                     | Only `list`/`create`/`invite`              | v0.2.0 / v1.2.0 |
| `erc`/`drc` `--format json\|markdown`, `--output`, `--strict`, `--rules`, `--category` | Only `--exit-zero`                         | v0.2.0          |
| `review` `--format`, `--severity`                                                      | Only `--output`/`--scope`/`--focus`        | v0.2.0          |
| `ask` `--format`/`--output` honored end-to-end                                         | Partial                                    | v0.2.0          |
| `export` manufacturer presets, `--zip` fab bundle, `--validate`, `--layers`            | Not built                                  | v0.3.0          |
| Export formats: ODB++, IPC-2581, DXF, PostScript                                       | Not built                                  | v0.3.0          |
| `components check --distributors` add `ti`, `amazon`                                   | jlcpcb/lcsc/digikey/mouser only            | v0.2.0          |
| `init` — project scaffolding + templates                                               | Not built                                  | v0.3.0          |
| Variant-aware CLI export (`--variant`)                                                 | GUI-only                                   | v1.1.0          |

## Polish backlog

Beyond new commands, a running list of UX/reliability refinements is tracked (terminal-experience and EDA-validation quality), prioritized across v0.2–v0.3:

* **Rendering:** colored pin types, top/bottom pin rows, multi-unit symbols, terminal-width-aware boxes, QFN/BGA footprint visuals
* **Input:** multiline prompts, input history, `stdin` piping (`cat x.kicad_sym | buildwithtrace ask …`), path tab-completion
* **Output:** `--quiet`/`--verbose`, generation progress, clickable file paths, diff view for edits, context-window usage
* **Auth:** token-expiry warnings, multi-account `--profile`
* **Reliability:** resume an interrupted stream, explicit proxy support, upload progress
* **Workflow:** git-aware auto-branch + `undo`, `watch` mode, pipeline chaining, `.tracerc`, saved templates, shell completion
* **EDA validation:** pin-count vs datasheet, KLC checks, footprint↔symbol matching, `.kicad_sym` version compatibility

## Upcoming

<Steps>
  <Step title="v0.2.0 — Manufacturing pipeline + scriptable checks">
    Real `order submit` + `order track`; `versions diff`; `teams switch`; structured `--format`/`--output` for `erc`/`drc`/`review`/`ask`; `autoroute`; `annotate`; resume interrupted generations; shell completions.
  </Step>

  <Step title="v0.3.0 — Placement/routing intelligence + richer export">
    `place`, `route`, `impedance`, `stackup`, `thermal`; `init` scaffolding; manufacturer export presets + fab bundles (ODB++/IPC-2581/DXF/PS); `.trace/context.md` AI memory.
  </Step>

  <Step title="v0.4.0 — Simulation + signal integrity">
    `simulate` (ngSPICE ac/dc/tran); `si` for true signal-integrity analysis (eye diagrams, crosstalk) — distinct from today's `signal` path tracing; `power`; watch mode.
  </Step>

  <Step title="v1.0.0 — Production hardening">
    Full docs↔code parity; `ci` one-command validation; CI/CD templates; Windows Action runner. (The Node.js SDK on npm has shipped — `@buildwithtrace/sdk`.)
  </Step>

  <Step title="v1.1.0+ — Interop, teams, enterprise">
    Eagle/OrCAD import; variant-aware export; multi-project workspaces; git-aware mode + `undo`; full team management; conversations/notifications; RBAC for CI tokens.
  </Step>
</Steps>

<Note>
  The canonical roadmap lives in the CLI repo's `ROADMAP.md` and is kept in sync with this page. If you find a command documented here that doesn't behave as described, that's a bug — please [report it](/resources/feature-requests).
</Note>