Skip to main content

Midcore CLI · Terminal-first

The Midcore agent, on the command line.

A single signed binary. The same agent, the same memory, the same policy stack as Midcore Shell — surfaced where most production work actually happens: the terminal, the shell pipeline, the CI runner.

Download the CLIRead the docs

What the CLI is for

Scriptable agent runs

`midcore run --plan plan.yaml` drives the whole agent loop from a config. No GUI, no clicks. Perfect for pipelines you want to commit and review.

CI / CD integration

Drop the binary into GitHub Actions, GitLab, Buildkite. Standard exit codes, JSON output, deterministic gates. Your CI sees agent runs the same way it sees tests.

Headless automation

Wire the CLI into cron, systemd timers, or Loom workflows. The agent runs, signs the receipts, writes to the audit chain, exits clean.

Local-first by default

Embeddings, vector search, file ops, git ops — all on your machine, no cloud round-trip. Cloud only when local can't keep up.

The five core commands

  • midcore agent — start an interactive agent session in the terminal.
  • midcore plan — run a structured plan; emit signed receipts on each step.
  • midcore pkb — query / ingest / scan your Personal Knowledge Base. 25+ subcommands.
  • midcore policy — evaluate Conscience policy packs locally before pushing.
  • midcore balance — show prepaid balance, recent receipts, holds.

What every install enforces

  • Sign-in required — first run prompts a device-code OAuth flow; no anonymous use.
  • Active subscription — cloud ops refuse 403 on inactive subscriptions before any provider is contacted.
  • Same audit chain — every CLI op writes the same hash-chained receipt as Midcore Shell. Replay it offline; hand it to a regulator.
  • Per-session caps — configurable spend ceiling per run. CLI refuses to blow through it without an explicit override flag.

Pricing — the same tier as every other Midcore app

The CLI doesn’t have its own subscription — one paid account unlocks the CLI, the Shell, the IDE, and the VS Code + Zed extensions. Same balance, same receipts, same audit. Pick the entry point that fits the moment.

Starter $19 CAD/mo is the floor. See the tier & product mapping for what you get at each tier, and the pricing page for the side-by-side comparison.

When to reach for the CLI vs the Shell

Use the CLI when…

  • You’re scripting an automation in CI
  • You want headless agent runs (cron, systemd, Loom)
  • You’re composing Midcore into a Unix pipeline
  • You prefer the keyboard for everything

Use Midcore Shell when…

  • You want every product surface in one window
  • You’re running Research, Robotics, or Finance flows visually
  • You want an interactive Maestro chat with rich UI
  • You want the Project Vault snapshot UI

Read more