interference-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Interference contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+<h1 align="center">interference</h1>
+
+<p align="center"><strong>The open-source coding agent that lives in your terminal.</strong></p>
+
+<p align="center">
+  TypeScript + Bun · Plan / Build modes · 9 tools · permissions · sessions with undo · 38 skills · subagents · TUI
+</p>
+
+---
+
+**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](https://bun.sh) · TypeScript · [Vercel AI SDK](https://ai-sdk.dev) (`ai` v7) · [zod](https://zod.dev) · [Ink 7.1](https://github.com/vadimdemedes/ink) + React 19.2 (TUI)
+
+## Quickstart
+
+```bash
+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
+
+![interference CLI](assets/screenshot.png)
+
+*(Capture your terminal with Cmd+Shift+4, save as `assets/screenshot.png`)*
+
+## Landing page
+
+A static landing page lives in [`site/`](site/).
+
+## License
+
+[MIT](LICENSE)

package/bun.lock

@@ -0,0 +1,159 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "interference",
+      "dependencies": {
+        "@ai-sdk/anthropic": "^4.0.1",
+        "@ai-sdk/deepseek": "^3.0.1",
+        "@ai-sdk/openai-compatible": "^3.0.1",
+        "@inkjs/ui": "^2.0.0",
+        "ai": "^7.0.4",
+        "ink": "^7.1.0",
+        "ink-text-input": "^6.0.0",
+        "react": "^19.2.7",
+        "zod": "^4.4.3",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "@types/react": "^19.2.17",
+        "ink-testing-library": "^4.0.0",
+        "typescript": "^5.6.0",
+      },
+    },
+  },
+  "packages": {
+    "@ai-sdk/anthropic": ["@ai-sdk/anthropic@4.0.1", "", { "dependencies": { "@ai-sdk/provider": "4.0.0", "@ai-sdk/provider-utils": "5.0.1" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-q9PMy0r3LGzSTu6FtYhFj6EesVpSpsEoPLsRKFnaK4YJd7SdUJlYIUJ4EXd5LTWzeXxk4r02z3gymo24c9jyQA=="],
+
+    "@ai-sdk/deepseek": ["@ai-sdk/deepseek@3.0.1", "", { "dependencies": { "@ai-sdk/provider": "4.0.0", "@ai-sdk/provider-utils": "5.0.1" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-isMBNuG8wWWZ8FvQ76Y8sp8L0ET6GCqD9WydRUA8WkcWJ/7PGnli6kE2fkfFVJF4fYS0JcAdLuxVnoTnngTT5w=="],
+
+    "@ai-sdk/gateway": ["@ai-sdk/gateway@4.0.4", "", { "dependencies": { "@ai-sdk/provider": "4.0.0", "@ai-sdk/provider-utils": "5.0.1", "@vercel/oidc": "3.2.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-xO0e9duft/uZlnDaIeBZmzTMjfdEz1kkDzWnhQNkJZZljsKWVi6IREZW9nAa+Dx6jYJssyxSUggaFYBAV1WZpw=="],
+
+    "@ai-sdk/openai-compatible": ["@ai-sdk/openai-compatible@3.0.1", "", { "dependencies": { "@ai-sdk/provider": "4.0.0", "@ai-sdk/provider-utils": "5.0.1" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-nUbQoGzdFZspb1cr6GUy+nR8Uvdi4/lCwTkdE9qKe+Qr2OVPsIKRIpyC9ewJ2uqUfl+1JlkWhPfR5l8bokNs4Q=="],
+
+    "@ai-sdk/provider": ["@ai-sdk/provider@4.0.0", "", { "dependencies": { "json-schema": "^0.4.0" } }, "sha512-fr9Gs89prDWiuox/T+kCA+i2cJkHpxU5S+tr4megjTzRC27ZsvFhwjU/+XrqqMbvBUlfmXxTOYWy8ng45dsjIg=="],
+
+    "@ai-sdk/provider-utils": ["@ai-sdk/provider-utils@5.0.1", "", { "dependencies": { "@ai-sdk/provider": "4.0.0", "@standard-schema/spec": "^1.1.0", "@workflow/serde": "4.1.0", "eventsource-parser": "^3.0.8" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-p9Ra+dN4jjHrssXvklNf4nFvWbj1KePMfUOs7nue0NuoIMbYFBULhX4Vu0+6DWLnw3+UsLL9+RCKLtzzU43Qpg=="],
+
+    "@alcalzone/ansi-tokenize": ["@alcalzone/ansi-tokenize@0.3.0", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-p+CMKJ93HFmLkjXKlXiVGlMQEuRb6H0MokBSwUsX+S6BRX8eV5naFZpQJFfJHjRZY0Hmnqy1/r6UWl3x+19zYA=="],
+
+    "@inkjs/ui": ["@inkjs/ui@2.0.0", "", { "dependencies": { "chalk": "^5.3.0", "cli-spinners": "^3.0.0", "deepmerge": "^4.3.1", "figures": "^6.1.0" }, "peerDependencies": { "ink": ">=5" } }, "sha512-5+8fJmwtF9UvikzLfph9sA+LS+l37Ij/szQltkuXLOAXwNkBX9innfzh4pLGXIB59vKEQUtc6D4qGvhD7h3pAg=="],
+
+    "@standard-schema/spec": ["@standard-schema/spec@1.1.0", "", {}, "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w=="],
+
+    "@types/bun": ["@types/bun@1.3.14", "", { "dependencies": { "bun-types": "1.3.14" } }, "sha512-h1hFqFVcvAvD9j9K7ZW7vd82aSA+rTdznZa+5bwvCwqSB1jmmfLcbIWhOLx1/+boy/xmjgCs/OMUL8hRJSmnPw=="],
+
+    "@types/node": ["@types/node@26.0.1", "", { "dependencies": { "undici-types": "~8.3.0" } }, "sha512-fc3KiUoBt6kie0N9bIW3E47vZsuaMf0PM2AaUpLCLT0s/LvX1nxAim6Fc049cNxODPpGm6qRAuUOB86SkRuPQw=="],
+
+    "@types/react": ["@types/react@19.2.17", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-MXfmqaVPEVgkBT/aY0aGCkRWWtByiYQXo3xdQ8r5RzuFrPiRn8Gar2tQdXSUQ2GKV3bkXckek89V8wQBY2Q/Aw=="],
+
+    "@vercel/oidc": ["@vercel/oidc@3.2.0", "", {}, "sha512-UycprH3T6n3jH0k44NHMa7pnFHGu/N05MjojYr+Mc6I7obkoLIJujSWwin1pCvdy/eOxrI/l3uDLQsmcrOb4ug=="],
+
+    "@workflow/serde": ["@workflow/serde@4.1.0", "", {}, "sha512-pav4F2BoirECWR7Nf1TKt+2eETcBj7jj4cBefQ8VXQCA6NPkaKeLfj/zMgi+3zYV5ZIBT4GuUiphsj0/b9hPQQ=="],
+
+    "ai": ["ai@7.0.4", "", { "dependencies": { "@ai-sdk/gateway": "4.0.4", "@ai-sdk/provider": "4.0.0", "@ai-sdk/provider-utils": "5.0.1" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-mZub080RWRxpWg8OY56KVnI3AoMVniccSWG+dwVb3nH81+GiNMDYBIdP41RLUivLpmU49pB7ssD7tvfIUaSaCA=="],
+
+    "ansi-escapes": ["ansi-escapes@7.3.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg=="],
+
+    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
+
+    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
+
+    "auto-bind": ["auto-bind@5.0.1", "", {}, "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg=="],
+
+    "bun-types": ["bun-types@1.3.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-4N0ig0fEomHt5R0KCFWjovxow98rIoRwKolrYdCcknNwMekCXRnWEUvgu5soYV8QXtVsrUD8B95MBOZGPvr6KQ=="],
+
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "cli-boxes": ["cli-boxes@4.0.1", "", {}, "sha512-5IOn+jcCEHEraYolBPs/sT4BxYCe2nHg374OPiItB1O96KZFseS2gthU4twyYzeDcFew4DaUM/xwc5BQf08JJw=="],
+
+    "cli-cursor": ["cli-cursor@4.0.0", "", { "dependencies": { "restore-cursor": "^4.0.0" } }, "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg=="],
+
+    "cli-spinners": ["cli-spinners@3.4.0", "", {}, "sha512-bXfOC4QcT1tKXGorxL3wbJm6XJPDqEnij2gQ2m7ESQuE+/z9YFIWnl/5RpTiKWbMq3EVKR4fRLJGn6DVfu0mpw=="],
+
+    "cli-truncate": ["cli-truncate@6.1.0", "", { "dependencies": { "slice-ansi": "^9.0.0", "string-width": "^8.2.0" } }, "sha512-ofWtXdvPO1WepoE9Gn4dPdZw+ADud1Yz9K+xm9FjK5vvrs/D60vrlKIQeSw1wJX4cphW2bnWi8GZSKvf9T6shw=="],
+
+    "code-excerpt": ["code-excerpt@4.0.0", "", { "dependencies": { "convert-to-spaces": "^2.0.1" } }, "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA=="],
+
+    "convert-to-spaces": ["convert-to-spaces@2.0.1", "", {}, "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ=="],
+
+    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
+
+    "deepmerge": ["deepmerge@4.3.1", "", {}, "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A=="],
+
+    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
+
+    "es-toolkit": ["es-toolkit@1.49.0", "", {}, "sha512-G5iZ6Pc/FNRY/soKZHC+TxGDD83rHUDXxzaWhGCX44vAv/tMs56WMusnm/KMNK+luUPsgA9U28cGr4RDlSzL2g=="],
+
+    "escape-string-regexp": ["escape-string-regexp@2.0.0", "", {}, "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w=="],
+
+    "eventsource-parser": ["eventsource-parser@3.1.0", "", {}, "sha512-kJezFj9YFAMLeORyi7aCLxLbD5/qWMQnoMVlVPyHIll7lgRJCc3JVln9Vgl9nwQi0YkMnhdGTMNn7CkRRAptMg=="],
+
+    "figures": ["figures@6.1.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0" } }, "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg=="],
+
+    "get-east-asian-width": ["get-east-asian-width@1.6.0", "", {}, "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA=="],
+
+    "indent-string": ["indent-string@5.0.0", "", {}, "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg=="],
+
+    "ink": ["ink@7.1.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.3.0", "ansi-escapes": "^7.3.0", "ansi-styles": "^6.2.3", "auto-bind": "^5.0.1", "chalk": "^5.6.2", "cli-boxes": "^4.0.1", "cli-cursor": "^4.0.0", "cli-truncate": "^6.0.0", "code-excerpt": "^4.0.0", "es-toolkit": "^1.45.1", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "scheduler": "^0.27.0", "signal-exit": "^3.0.7", "slice-ansi": "^9.0.0", "stack-utils": "^2.0.6", "string-width": "^8.2.0", "terminal-size": "^4.0.1", "type-fest": "^5.5.0", "widest-line": "^6.0.0", "wrap-ansi": "^10.0.0", "ws": "^8.20.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.2.0", "react": ">=19.2.0", "react-devtools-core": ">=6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-VWE6/yeLtFCJBNLflyI2OSylyXK1Rc24LuXup8Qt+icwkmmycFNdbn8IkSp6Frc0h1iA0NOvvi1ajW44U/w3Qg=="],
+
+    "ink-testing-library": ["ink-testing-library@4.0.0", "", { "peerDependencies": { "@types/react": ">=18.0.0" }, "optionalPeers": ["@types/react"] }, "sha512-yF92kj3pmBvk7oKbSq5vEALO//o7Z9Ck/OaLNlkzXNeYdwfpxMQkSowGTFUCS5MSu9bWfSZMewGpp7bFc66D7Q=="],
+
+    "ink-text-input": ["ink-text-input@6.0.0", "", { "dependencies": { "chalk": "^5.3.0", "type-fest": "^4.18.2" }, "peerDependencies": { "ink": ">=5", "react": ">=18" } }, "sha512-Fw64n7Yha5deb1rHY137zHTAbSTNelUKuB5Kkk2HACXEtwIHBCf9OH2tP/LQ9fRYTl1F0dZgbW0zPnZk6FA9Lw=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@5.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.1" } }, "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ=="],
+
+    "is-in-ci": ["is-in-ci@2.0.0", "", { "bin": { "is-in-ci": "cli.js" } }, "sha512-cFeerHriAnhrQSbpAxL37W1wcJKUUX07HyLWZCW1URJT/ra3GyUTzBgUnh24TMVfNTV2Hij2HLxkPHFZfOZy5w=="],
+
+    "is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
+
+    "json-schema": ["json-schema@0.4.0", "", {}, "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA=="],
+
+    "mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
+
+    "onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
+
+    "patch-console": ["patch-console@2.0.0", "", {}, "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA=="],
+
+    "react": ["react@19.2.7", "", {}, "sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ=="],
+
+    "react-reconciler": ["react-reconciler@0.33.0", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.0" } }, "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA=="],
+
+    "restore-cursor": ["restore-cursor@4.0.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg=="],
+
+    "scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
+
+    "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
+
+    "slice-ansi": ["slice-ansi@9.0.0", "", { "dependencies": { "ansi-styles": "^6.2.3", "is-fullwidth-code-point": "^5.1.0" } }, "sha512-SO/3iYL5S3W57LLEniscOGPZgOqZUPCx6d3dB+52B80yJ0XstzsC/eV8gnA4tM3MHDrKz+OCFSLNjswdSC+/bA=="],
+
+    "stack-utils": ["stack-utils@2.0.6", "", { "dependencies": { "escape-string-regexp": "^2.0.0" } }, "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ=="],
+
+    "string-width": ["string-width@8.2.1", "", { "dependencies": { "get-east-asian-width": "^1.5.0", "strip-ansi": "^7.1.2" } }, "sha512-IIaP0g3iy9Cyy18w3M9YcaDudujEAVHKt3a3QJg1+sr/oX96TbaGUubG0hJyCjCBThFH+tFpcIyoUHUn1ogaLA=="],
+
+    "strip-ansi": ["strip-ansi@7.2.0", "", { "dependencies": { "ansi-regex": "^6.2.2" } }, "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w=="],
+
+    "tagged-tag": ["tagged-tag@1.0.0", "", {}, "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng=="],
+
+    "terminal-size": ["terminal-size@4.0.1", "", {}, "sha512-avMLDQpUI9I5XFrklECw1ZEUPJhqzcwSWsyyI8blhRLT+8N1jLJWLWWYQpB2q2xthq8xDvjZPISVh53T/+CLYQ=="],
+
+    "type-fest": ["type-fest@5.7.0", "", { "dependencies": { "tagged-tag": "^1.0.0" } }, "sha512-1URUxUqfHFM1c+zfSPsa3gnkO7Aq21qyH75SIduNYz4SzY964rn1X2vCMQaHSHhktiw+0kPa2iyb6PUpXqB6Vg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@8.3.0", "", {}, "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ=="],
+
+    "widest-line": ["widest-line@6.0.0", "", { "dependencies": { "string-width": "^8.1.0" } }, "sha512-U89AsyEeAsyoF0zVJBkG9zBgekjgjK7yk9sje3F4IQpXBJ10TF6ByLlIfjMhcmHMJgHZI4KHt4rdNfktzxIAMA=="],
+
+    "wrap-ansi": ["wrap-ansi@10.0.0", "", { "dependencies": { "ansi-styles": "^6.2.3", "string-width": "^8.2.0", "strip-ansi": "^7.1.2" } }, "sha512-SGcvg80f0wUy2/fXES19feHMz8E0JoXv2uNgHOu4Dgi2OrCy1lqwFYEJz1BLbDI0exjPMe/ZdzZ/YpGECBG/aQ=="],
+
+    "ws": ["ws@8.21.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g=="],
+
+    "yoga-layout": ["yoga-layout@3.2.1", "", {}, "sha512-0LPOt3AxKqMdFBZA3HBAt/t/8vIKq7VaQYbuA8WxCgung+p9TVyKRYdpvCb80HcdTN2NkbIKbhNwKUfm3tQywQ=="],
+
+    "zod": ["zod@4.4.3", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],
+
+    "ink-text-input/type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "interference-agent",
+  "version": "0.1.0",
+  "description": "The open-source coding agent that lives in your terminal.",
+  "type": "module",
+  "license": "MIT",
+  "author": "ricciviero",
+  "repository": "github:ricciviero/interference",
+  "homepage": "https://github.com/ricciviero/interference#readme",
+  "keywords": ["ai", "coding-agent", "terminal", "cli", "bun", "typescript", "llm", "open-source"],
+  "bin": {
+    "interference": "./src/cli.ts"
+  },
+  "scripts": {
+    "interference": "bun run src/cli.ts",
+    "start": "bun run src/cli.ts",
+    "dev": "bun run --watch src/cli.ts",
+    "typecheck": "bunx tsc --noEmit",
+    "build": "bun build src/cli.ts --compile --minify --sourcemap --outfile dist/interference",
+    "test": "bun test ./src"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^4.0.1",
+    "@ai-sdk/deepseek": "^3.0.1",
+    "@ai-sdk/openai-compatible": "^3.0.1",
+    "@inkjs/ui": "^2.0.0",
+    "ai": "^7.0.4",
+    "ink": "^7.1.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.7",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19.2.17",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/src/agent/compaction.ts

@@ -0,0 +1,114 @@
+import { generateText, type ModelMessage } from "ai";
+import { resolveModel } from "../provider.ts";
+import { currentProvider } from "../config.ts";
+
+const COMPACT_THRESHOLD = 0.9;
+const DEFAULT_CONTEXT = 200_000;
+
+function getContextLimit(): number {
+  return currentProvider().contextLimit ?? DEFAULT_CONTEXT;
+}
+
+function estimateTokens(text: string): number {
+  return Math.ceil(text.length / 3.5);
+}
+
+export function estimateMessagesTokens(messages: ModelMessage[]): number {
+  let total = 0;
+  for (const m of messages) {
+    if (typeof m.content === "string") {
+      total += estimateTokens(m.content);
+    } else if (Array.isArray(m.content)) {
+      for (const part of m.content as Array<{ text?: string; type: string }>) {
+        if (part.text) total += estimateTokens(part.text);
+      }
+    }
+  }
+  return total;
+}
+
+export function shouldCompact(messages: ModelMessage[]): boolean {
+  const limit = getContextLimit();
+  const used = estimateMessagesTokens(messages);
+  return used > limit * COMPACT_THRESHOLD;
+}
+
+export function getUsagePercent(messages: ModelMessage[]): number {
+  const limit = getContextLimit();
+  const used = estimateMessagesTokens(messages);
+  return Math.round((used / limit) * 100);
+}
+
+export async function compactMessages(
+  messages: ModelMessage[],
+  preserveRecentTurns = 2,
+): Promise<ModelMessage[]> {
+  if (messages.length === 0) return messages;
+
+  const userIndices: number[] = [];
+  for (let i = 0; i < messages.length; i++) {
+    if (messages[i]!.role === "user") userIndices.push(i);
+  }
+
+  if (userIndices.length <= preserveRecentTurns) return messages;
+
+  const splitIndex = userIndices[userIndices.length - preserveRecentTurns]!;
+  const head = messages.slice(0, splitIndex);
+  const tail = messages.slice(splitIndex);
+
+  const summary = await generateSummary(head);
+  if (!summary) return messages;
+
+  const compacted: ModelMessage[] = [
+    {
+      role: "user",
+      content: `<compacted_summary>\n${summary}\n</compacted_summary>\n\nContinue from where you left off.`,
+    },
+    {
+      role: "assistant",
+      content: "I'll continue with the remaining context.",
+    },
+    ...tail,
+  ];
+
+  return compacted;
+}
+
+async function generateSummary(
+  messages: ModelMessage[],
+): Promise<string | null> {
+  const serialized = serializeMessages(messages);
+  if (serialized.length < 100) return null;
+
+  const prompt = `Summarize the following conversation between a user and an AI coding agent.
+Focus on: what was done, which files were modified, key decisions made, and what remains to do.
+Be concise but comprehensive. Write in the same language as the conversation.
+
+<conversation>
+${serialized.slice(0, 16000)}
+</conversation>
+
+Return ONLY the summary, no preamble.`;
+
+  try {
+    const result = await generateText({
+      model: resolveModel(),
+      prompt,
+      maxOutputTokens: 2000,
+    });
+    return result.text.trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+function serializeMessages(messages: ModelMessage[]): string {
+  const lines: string[] = [];
+  for (const m of messages) {
+    const role = m.role === "user" ? "User" : m.role === "assistant" ? "Agent" : m.role;
+    const content = typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+    const truncated = content.length > 2000 ? content.slice(0, 2000) + "…" : content;
+    lines.push(`[${role}]: ${truncated}`);
+  }
+  return lines.join("\n");
+}

package/src/agent/loop.ts

@@ -0,0 +1,94 @@
+import { streamText, stepCountIs, type ModelMessage } from "ai";
+import { resolveModel } from "../provider.ts";
+import { currentMode, reasoningConfig, type AgentMode } from "../config.ts";
+import { systemPrompt } from "./prompt.ts";
+import { toolsForMode } from "../tools/index.ts";
+import { trackUsage } from "../cost.ts";
+
+export type Chunk =
+  | { type: "text" | "reasoning"; text: string }
+  | { type: "tool-call"; toolName: string; input: unknown }
+  | { type: "tool-result"; toolName: string; output: string; isError: boolean };
+
+export async function* runTurn(
+  messages: ModelMessage[],
+  signal?: AbortSignal,
+  mode?: AgentMode,
+  skillBodies?: string[],
+  overrideSystem?: string,
+): AsyncGenerator<Chunk> {
+  const reasoning = reasoningConfig();
+  const effectiveMode = mode ?? currentMode();
+  const tools = toolsForMode(effectiveMode);
+
+  let system = overrideSystem ?? systemPrompt(effectiveMode);
+  if (skillBodies && skillBodies.length > 0) {
+    system += "\n\n<skill_context>\n" + skillBodies.join("\n\n---\n\n") + "\n</skill_context>";
+  }
+
+  const result = streamText({
+    model: resolveModel(),
+    system,
+    messages,
+    tools,
+    stopWhen: stepCountIs(20),
+    abortSignal: signal,
+    onError: () => {},
+    ...(reasoning.providerOptions
+      ? {
+          providerOptions: reasoning.providerOptions as Parameters<
+            typeof streamText
+          >[0]["providerOptions"],
+        }
+      : {}),
+    ...(reasoning.maxOutputTokens ? { maxOutputTokens: reasoning.maxOutputTokens } : {}),
+  });
+
+  for await (const part of result.fullStream) {
+    switch (part.type) {
+      case "text-delta":
+        yield { type: "text", text: part.text };
+        break;
+
+      case "reasoning-delta":
+        yield { type: "reasoning", text: part.text };
+        break;
+
+      case "tool-call":
+        yield { type: "tool-call", toolName: part.toolName, input: part.input };
+        break;
+
+      case "tool-result": {
+        const tr = part as unknown as {
+          toolName: string;
+          output: unknown;
+          error?: unknown;
+        };
+        const err = tr.error;
+        const out = tr.output;
+        yield {
+          type: "tool-result",
+          toolName: tr.toolName,
+          output: err
+            ? String(err)
+            : typeof out === "string"
+              ? out
+              : JSON.stringify(out),
+          isError: !!err,
+        };
+        break;
+      }
+
+      case "error":
+        throw part.error;
+    }
+  }
+
+  const response = await result.response;
+  messages.push(...response.messages);
+
+  const usage = await result.usage;
+  if (usage) {
+    trackUsage(usage.inputTokens ?? 0, usage.outputTokens ?? 0);
+  }
+}

package/src/agent/prompt.ts

@@ -0,0 +1,89 @@
+import { loadInstructions, formatInstructionBlock, type InstructionBlock } from "../context.ts";
+import { loadSkillRegistry, bootstrapSkills } from "../skills.ts";
+
+let cachedInstructions: InstructionBlock[] | null = null;
+let skillsSummary: string | null = null;
+
+export async function initInstructions(): Promise<InstructionBlock[]> {
+  cachedInstructions = await loadInstructions();
+  const registry = await loadSkillRegistry();
+  if (registry.length > 0) {
+    skillsSummary = "Available skills (use /<name> or trigger by description):\n" +
+      registry.map((s) => `- \`${s.name}\`: ${s.description}`).join("\n");
+  }
+  return cachedInstructions;
+}
+
+export function systemPrompt(mode: "plan" | "build", instructions?: InstructionBlock[]): string {
+  const blocks = instructions ?? cachedInstructions ?? [];
+  const instructionText = blocks.length > 0
+    ? "\n<instructions>\n" + blocks.map(formatInstructionBlock).join("\n\n") + "\n</instructions>\n"
+    : "";
+
+  const skillsText = skillsSummary
+    ? "\n<available_skills>\n" + skillsSummary + "\n</available_skills>\n"
+    : "";
+
+  const envSection = `Working directory: ${process.cwd()}
+OS: ${process.platform}
+Date: ${new Date().toISOString().split("T")[0]}`;
+
+  const base = `You are interference, an AI coding agent running in the user's terminal.
+
+<environment>
+${envSection}
+</environment>${instructionText}${skillsText}
+You have access to these tools:
+- read: read file contents with line numbers (use offset/limit for large files)
+- ls: list files and directories
+- glob: find files by pattern (e.g. "src/**/*.ts")
+- grep: search file contents with regex
+- webfetch: fetch a URL and return its text content (for documentation, API references, research)
+- todowrite: maintain a structured task list. Use for multi-step work (3+ distinct steps):
+       create the plan up front, then update statuses in real time. Keep exactly ONE task
+       'in_progress' at a time and mark tasks 'completed' as soon as they are done. Skip it
+       for trivial single-step tasks.
+- question: ask the user one or more multiple-choice questions when a decision is genuinely
+       ambiguous and you cannot resolve it from the request, the code, or sensible defaults.
+       Execution pauses until the user answers. Use sparingly; prefer sensible defaults.`;
+
+  if (mode === "build") {
+    return (
+      base +
+      `
+- write: create or overwrite a file
+- edit: replace a string in a file. The oldString must match EXACTLY ONCE in the file.
+       Use 'replaceAll: true' to replace all occurrences.
+       Prefer edit over write for targeted changes. If oldString matches multiple
+       times, add more surrounding context to make it unique.
+- bash: execute a shell command. Use for git, tests, build, package management.
+       NEVER use interactive commands (no -i flag, no vim/nano). Commands that
+       may be destructive (rm, sudo, curl pipe, force push) are blocked.
+- task: launch a subagent for complex multi-step tasks (types: 'explore' for read-only,
+       'general' for full access). Use when a task requires isolated context.
+- webfetch: fetch content from a URL (HTML is stripped to text). Use for documentation,
+       API references, or researching external resources.
+
+Rules:
+- Be concise and precise. Prefer short, direct answers; expand only when asked.
+- Use edit for small changes, write only for new files or complete rewrites.
+- Before using bash, explain what the command will do.
+- After editing a file, the user may need to approve the change.
+- When you are unsure, say so instead of guessing.
+- Never use emojis in responses.
+- Format code in fenced blocks with the right language tag.`
+    );
+  }
+
+  return (
+    base +
+    `
+You are running in Plan mode (read-only). You cannot modify files or execute commands.
+- Be concise and precise. Prefer short, direct answers; expand only when asked.
+- When exploring the codebase: use ls/glob to map structure, grep to find code, read to inspect.
+- Answer with specific file:line references.
+- When you are unsure, say so instead of guessing.
+- Never use emojis in responses.
+- Format code in fenced blocks with the right language tag.`
+  );
+}