Quick start

Start a session

cd ~/code/my-project
deltacode

The header shows the current project folder, provider, and model. The input at the bottom is where you type. Just ask in plain language:

You: what does this repo do?
You: add tests for the parser module
You: build a todo app

How the agent works

The lead agent plans around your project’s conventions before touching anything:

1. It explores — globs for files, reads the important ones (package.json, tsconfig, README).
2. It acts through tools — reading, writing, editing, running commands, searching — and shows each call as a structured row with its result.
3. It verifies — runs builds, typechecks, or tests when the task calls for it.
4. It only works outside the project folder when you approve wider scope.

The permission prompt

Every sensitive action asks first:

permission — lead
[a] allow · [d] deny · [A] allow always (this session)

bash permission defaults to ask. To let commands run without prompting, set permissions.bash: "allow" in ~/.delta/config.json.

Thinking and reasoning

Free models stream their reasoning live in a dim “thinking” region at the top of the reply, which collapses to a thought for Ns line once the answer starts.

Interrupting

Key	Effect
esc	Interrupt the current turn
esc esc	Abort the turn
ctrl-c	Quit the app

Next steps

• Browse Slash commands
• Pick another Provider
• Tune Configuration