Use cases

How it is used.

These are jobs you can finish with Matcha CLI.

They are not customer stories, and they are not a command manual.

01

Write a feature and run the tests

When

The change is clear. You want it in the repo, and you want to know it runs.

You say

Add rate limiting to the API and cover it with tests.

Matcha CLI reads the files, edits them, and shows the diff in the same turn.

Then it runs the tests and keeps going from the result.

There is no account and no product cloud. The session stays on your machine.

02

Plan first when the path is unclear

When

The approach is still unclear. Editing first would waste work.

You say

Move auth from cookies to JWT. Plan first. Do not edit yet.

/plan starts a planning turn. The assistant reads the repo and writes a plan.

Code waits until you agree.

File edits and commands ask first.

03

Fix a failing test

When

A test is red. You want to follow the failure and fix it.

You say

Fix the failing auth test and run it.

The assistant inspects the failure, edits the code or the assertion, and runs it again.

That is how you debug here: fix tests, inspect failures.

It is not a separate Debug product.

04

Switch models mid-session

When

You want a different model from your Provider, without leaving the work.

You say

/model

The model picker opens for the current Provider. The session stays open.

Requests go to the Provider you chose.

MatchaCode is not a model provider.

05

Keep using the repo's rules

When

The repo already has conventions. You should not restate them every turn.

You say

Keep going in this repo. Follow the project rules.

Matcha CLI reads AGENTS.md, CLAUDE.md, and Cursor rules.

/import-claude previews first, then imports.

Rules stay local. There is no plugin marketplace.

06

Run one turn from a script

When

You want one turn from a command or a script you already have.

You say

Fix the failing auth test and run it.

matcha -p takes a prompt, runs tools, prints the result, and exits.

It runs on your machine.

This is not a product cloud, and it is not a CI product.

Get started