Matcha CLI · Available now
MatchaCode
A calmer way to ship code.
From an idea to code that runs.
Read the repo, plan the change, write the feature, and run the tests from your terminal. Bring the models you want.
Add rate limiting to the API and cover it with tests.
MatchaCode
Reading src/api/route.ts, src/api/route.test.ts
- export const POST = handler+ export const POST = withRateLimit(handler)
Rate limiting added. 12 tests passed.
Use cases
A complete turn.
Add rate limiting to the API and cover it with tests.
MatchaCode
Reading src/api/route.ts, src/api/route.test.ts
- export const POST = handler+ export const POST = withRateLimit(handler)
Rate limiting added. 12 tests passed.
Features
What it can do.
- 01
Read the repo
Read files and search the codebase to see how the project works.
- 02
Write features and edit code
Change files directly. Edits appear as inline diffs.
- 03
Plan before editing
When the path is unclear, read first and propose a plan. Code waits for your say-so.
- 04
Fix tests, inspect failures
Run commands and tests, inspect the result, then keep working from the failure.
- 05
Switch models
Open the model picker during a session and use a model from your Provider.
- 06
Bring rules and tools
Read project rules and connect the tools you use through MCP and skills.
The workspace
The room is the terminal.
The same agent will later meet you in the editor and on the desktop. The workspace you can use now is this room in the terminal.
Request
Add rate limiting to the API and cover it with tests.
Read
MatchaCode
Reading src/api/route.ts, src/api/route.test.ts, and AGENTS.md
Plan
- 01Wrap the handler in a rate-limit layer
- 02Add tests. Keep the existing assertions.
Change
- export const POST = handler+ export const POST = withRateLimit(handler)
Command
npm test
Rate limiting added. 12 tests passed.
Promise
What stays yours.
Sessions and rules stay on your machine. Inference goes to the Provider you choose.
01
Your machine.
Sessions and rules live in ~/.matcha. There is no MatchaCode account and no product cloud.
02
Your models.
Inference goes to the Provider you choose. MatchaCode is not a model provider.
03
Your say-so.
File edits and shell commands ask first. Plan when you need to. Sandbox is optional.
Surfaces
The CLI is available now.
CLI
Available now
Read the repo, edit files, and run commands in the terminal.
DownloadIDE Plugin
Coming soon
The same agent, in your editor.
Coming soonDesktop App
Coming soon
A desktop client, later.
Coming soonMobile App
Coming soon
Continue the same workflow on your phone, later.
Coming soon
CLI
Work in the terminal.
- 01
Work in the repo
Attach files with @. Diffs, commands, and task lists share one conversation.
matcha "fix the failing auth test and run it" - 02
Pick up where you left off
/resume opens a previous session. matcha -c continues the latest one. You can also rewind a turn.
matcha -c - 03
Plan, then edit
When the approach is ambiguous, read and propose. Code waits for your say-so.
/plan - 04
Switch models in-session
Open the current Provider model picker without leaving the workflow.
/model
Bring yours
Your rules can come with you.
Matcha CLI reads the conventions other assistants already use. You do not start over.
- 01
Reads the files as they are
AGENTS.mdCLAUDE.mdCursor rules
- 02
Preview Claude config, then import
/import-claudePreviewImport
- 03
Continue a Cursor, Claude, or Codex session
/resume-cursor/resume-claude/resume-codex
Models
Use the models you want.
Bring an API key for xAI, OpenAI, or Anthropic, or point at Ollama or another compatible endpoint. Login does not open a browser. There is no MatchaCode account.
MatchaCode is not a model provider. These names are examples of closed, open, local, and aggregator endpoints. They are not a native Provider catalog, and they are not endorsement.
Start
Get started.
Download the CLI, pick a model, and start. macOS and Linux are the primary platforms.
curl -fsSL https://get.matcha.dev | shMatchaCode itself is free for now. There is no account and no product cloud. Model usage is billed by your Provider.