Questions? hello@viberation.devGet supportBlogDocsChangelog
Get started
Fundamentals

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.

Ali Rizwan
4 min read1 views0 comments

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.

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.

More tools

Code editors on your computer. Open app only works once it is installed, so use Get it first if you do not have it.

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.