minimal terminal coding agent

Code with an agent that stays in your terminal.

Rune is a small, fast coding agent written in Go. It ships with local file and shell tools, safe plan mode, branching sessions, markdown skills, custom subagents, MCP plugins, and Codex/Groq/Ollama provider support.

Install Rune → View on GitHub

Glowing terminal prompt with rune glyphs

Quick start

Install, log in, run.

The installer downloads the latest GitHub release for macOS or Linux. You can also install from source with go install github.com/khang859/rune/cmd/rune@latest.

~/dev $ rune

$ curl -fsSL https://raw.githubusercontent.com/khang859/rune/main/install.sh | sh

What it does

A focused agent loop with the pieces you actually need.

Rune keeps the core workflow compact: understand the repo, make surgical edits, run targeted checks, and preserve context across sessions.

rw

Local tools

Read, write, edit, and run shell commands with repository-aware context and focused diffs.

/p

Plan mode

Enter a safe planning state where edits and bash are disabled until you approve the path forward.

⎇

Branching sessions

Jump through the conversation tree, resume old work, and compact long histories when needed.

sk

Skills

Drop markdown skills into your home or project directory to teach Rune repeatable workflows.

ag

Subagents

Define specialized agents for exploration, validation, reviews, or any project-specific role.

mcp

MCP plugins

Connect external tools through Model Context Protocol configuration in ~/.rune/mcp.json.

Providers

Use hosted models or local ones.

Codex is the default provider. Groq and Ollama are available when you want fast hosted inference or a fully local model.

✓CodexOAuth login via your ChatGPT account.

✓GroqAPI-key based provider for fast hosted models.

✓OllamaRun local models such as llama3.2.

providers

$ rune --provider groq
# or configure in the TUI with /providers

$ export GROQ_API_KEY="..."
$ rune --provider groq

$ ollama pull llama3.2
$ rune --provider ollama --model llama3.2

Learn more

Docs for the workflows behind Rune.

Start with the key concepts, then customize Rune with skills, subagents, MCP, and providers.

ArchitectureHow Rune is put together. Plan ModeSafe planning before acting. ProvidersCodex, Groq, and Ollama. MCPPlugin configuration. SkillsReusable markdown workflows. SubagentsSpecialized helper agents. KeybindingsInteractive TUI controls. Web toolsSearch and fetch options.

Open source

Bring a coding agent to any terminal.

Rune is MIT licensed and designed to stay small, understandable, and useful for real development work.

Star on GitHub Copy install command