Coding CLIs: the terminal as the interface
A coding CLI is an AI agent that lives in your terminal rather than a chat window or a sidebar. The difference is not the typing. It is that it can run your tests, read what broke, and try again without asking you to paste anything.
A chat window gives you an answer. You copy it into your editor, run it, something fails, you copy the error back. That loop is most of the time you spend, and you are the one carrying the messages.
A coding CLI closes that loop. It runs in your project folder, so it can open your files, edit them, run your tests, read the failure, and go again. You stop being the courier. That is the whole pitch, and it is also the whole risk: something that can edit files and run commands without asking you each time is powerful in exactly the way that is hard to undo.
What they all have in common
They differ in which model they use and what they cost, and the directory covers that per tool. Underneath, they are the same shape: They work in a folder. Run one in your project and that project is its world. They ask before doing something irreversible, at least by default. Read the thing it is asking about. The prompt is the safety feature. They read an instructions file. This is the part people skip, and it is the part that decides whether the tool is any good at your project.
Where each one keeps its things
Two separate concerns: its own settings and sign-in, which are yours, and the instructions it reads about this project, which belong to the team. Pick your tool.
Look it up for
Command: claude Settings and sign-in: ~/.claude/ Instructions for this project: CLAUDE.md Instructions for every project, yours only: ~/.claude/CLAUDE.md AGENTS.md: Reads it only where there is no CLAUDE.md.
Command: codex Settings and sign-in: ~/.codex/ Instructions for this project: AGENTS.md Instructions for every project, yours only: ~/.codex/AGENTS.md AGENTS.md: Reads it.
Command: gemini Settings and sign-in: ~/.gemini/ Instructions for this project: GEMINI.md Instructions for every project, yours only: ~/.gemini/GEMINI.md AGENTS.md: Reads GEMINI.md instead, unless you name AGENTS.md in its config.
Command: opencode Settings and sign-in: ~/.config/opencode/ Instructions for this project: AGENTS.md Instructions for every project, yours only: ~/.config/opencode/AGENTS.md AGENTS.md: Reads it.
Command: qwen Settings and sign-in: ~/.qwen/ Instructions for this project: QWEN.md Instructions for every project, yours only: ~/.qwen/QWEN.md AGENTS.md: Reads it.
Command: aider Settings and sign-in: ~/.aider.conf.yml Instructions for this project: CONVENTIONS.md AGENTS.md: Does not read it.
The instructions file is the whole game
A terminal agent with no instructions re-derives your project from scratch every session: how to run the tests, where things live, what the conventions are. It will guess, and it will guess the industry default rather than your actual setup. Ten lines fixes most of it. The build and test commands. Where the important code lives. Two or three rules it keeps getting wrong.
Try one properly
The first session people run is usually "write me a feature", which is the hardest thing to judge. Start with something where you already know the right answer, so you can tell whether it did well.
Paste this into your CLI
Read this project and tell me how to run it, how to run its tests, and what the three most important folders are. Do not change any files.
Open it in your AI tool. Clicking copies the prompt, and ChatGPT and Grok open with it already filled in.
- Claude(opens in a new tab)
- ChatGPT(opens in a new tab)
- Qwen(opens in a new tab)
- DeepSeek(opens in a new tab)
- Kimi(opens in a new tab)
- Grok(opens in a new tab)
More tools
App builders, in your browser:
Code editors on your computer. Open app only works once it is installed, so use Get it first if you do not have it.
- CursorOpen appGet it(opens in a new tab)
- VS CodeOpen appGet it(opens in a new tab)
- Antigravity IDEOpen appGet it(opens in a new tab)
- Antigravity 2.0Open appGet it(opens in a new tab)
Want the full list? Browse all app builders and coding editors (IDEs).
The third one is the one to actually keep. Have it draft the file, read it yourself, delete half of it, and commit what is left.
Picking one
Honest answer: start with whichever one matches a subscription you already pay for, and switch later if it annoys you. They are close enough that the choice matters less than the habits, and your instructions file mostly moves between them. The comparisons that matter — pricing, which models, whether you can bring your own key, whether it runs local models — are on each tool's page in the directory, where they get kept up to date.
Comments
Sign in to join the discussion.
Nothing here yet. If something in this piece worked, or did not, say so.