Skip to content

Getting started

DeltaCode is a coding agent that lives in your terminal. It reads your project, plans around its conventions, and does the work with you — writing files, running commands, searching the codebase, and delegating to specialist agents when a task fits them better.

It is built for macOS, is open source (Apache-2.0), and ships with a free model tier that needs no API key of your own.

What you need

  • macOS (Apple Silicon or Intel)
  • A terminal — Terminal.app, iTerm2, or anything else you like
  • Nothing else. The installer fetches Bun for you if it isn’t already installed.

The sixty-second version

Terminal window
curl -fsSL https://raw.githubusercontent.com/wehnnit/DeltaCode/main/install.sh | bash
cd ~/some/project
deltacode

On first launch, the setup screen appears:

  1. Pick Delta Free Models — no key needed, just accept the fair-use statement.
  2. Or pick any other provider and paste your own API key.
  3. Done. Ask for something:
You: build a todo app

The lead agent explores the project, makes the files, and verifies the result.

What happens next

  • Type / in the app to see every command.
  • Type /usage to see today’s free-model budget.
  • Type /new to start a fresh chat.
  • Esc interrupts a running turn; esc esc aborts it.

See Install, Quick start, and Slash commands for the details.