interference

The open-source coding agent that lives in your terminal.

TypeScript + Bun · Plan / Build modes · 9 tools · permissions · sessions with undo · 38 skills · subagents · TUI

---

interference is an AI coding agent for the terminal. You describe a task; it explores your codebase and edits files or runs commands through an agentic tool-calling loop — with explicit permissions and a read-only Plan mode so nothing happens without your say-so.

Features

• 9 tools: read · ls · glob · grep · webfetch · write · edit · bash · task (subagent)
• Plan & Build modes — explore read-only, switch to full access when ready
• Permissioned by design — allow / ask / deny enforced in code, not in the prompt; dangerous commands auto-blocked (rm -rf, sudo, curl | sh)
• 38 skills — auto-detected by keyword matching, or invoked explicitly via /skill-name; full Agent Skills format support
• Subagents — delegate complex tasks to isolated agents (explore for read-only, general for full access)
• Atomic edit — unique-match string replacement with replaceAll support
• Safe bash — timeout, output truncation, exit code, dangerous-command deny list
• Session persistence — messages saved per-project, resume with --continue; /sessions picker
• Undo / redo — file snapshots before every mutation; /undo /redo
• Slash commands — /help /clear /init /model /plan /build /undo /redo /compact /sessions /rename /provider /thinking
• /init — analyzes your project and generates AGENTS.md
• /provider — manage API keys interactively (stored in ~/.interference/auth.json)
• Skill invocation — explicit /skill-name + automatic keyword matching on description
• Context compaction — auto-summarizes conversation at ~90% context limit
• Config file — per-project interference.json (model, permissions, mode, instructions)
• Diff view — color-coded (+/-, green/red) in TUI for every edit/write
• TUI with Ink — <Static> history, streaming, spinner, TextInput, status footer (model / mode / context% / cost / git branch), pickers (model, provider, thinking), slash autocomplete, session list, toast, welcome screen
• Multi-provider — DeepSeek, OpenAI (GPT-5.5), Anthropic (Claude), Zhipu (GLM), Moonshot (Kimi) + any OpenAI-compatible endpoint
• Reasoning/thinking — distinct ┄ thinking blocks for every provider, enabled at max
• Cost tracking — real-time cost estimation per model
• AGENTS.md & CLAUDE.md — auto-loaded from project tree into system prompt
• Italian — made in Italy, MIT licensed, European

Why

• Terminal-native — no editor lock-in, no web UI; just your shell
• Permissioned by design — allow / ask / deny enforced in code
• European / by choice — Italian, MIT, GDPR-native, no vendor lock-in
• Radically transparent — every tool call, reasoning step, and API cost shown live

Stack

Bun · TypeScript · Vercel AI SDK (ai v7) · zod · Ink 7.1 + React 19.2 (TUI)

Quickstart

bun install
# Set API key in .env (Bun auto-loads it)
echo 'DEEPSEEK_API_KEY=sk-...' > .env
bun run interference

Requires Bun 1.3+ (Node ≥22 / React ≥19.2 for the Ink TUI).

Screenshot

(Capture your terminal with Cmd+Shift+4, save as assets/screenshot.png)

Landing page

A static landing page lives in site/.

License

MIT