![\"Porcupine\"](\"https://raw.githubusercontent.com/Abd0r/porcupineai/main/Porcupine/packages/coding-agent/assets/porcupine-banner.png\")
\n\n \n
\n ![\"CI\"](\"https://github.com/Abd0r/porcupineai/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"npm](\"https://img.shields.io/npm/v/@porcupineai/porcupineai\")
![\"npm](\"https://img.shields.io/npm/dt/@porcupineai/porcupineai\")
![\"MIT](\"https://img.shields.io/badge/License-MIT-EA9B34\"){kind=icon}
![\"GitHub](\"https://img.shields.io/github/stars/Abd0r/porcupineai\")
\n Give Porcupine a goal. It reasons, routes capabilities, uses tools, delegates work, verifies the result, and keeps risky action inside the permission boundary you control.\n
\n\n\n Get started ·\n Why Porcupine ·\n Capabilities ·\n Evaluation ·\n Safety ·\n Documentation\n
\n\n\n Built on top of Pi (MIT).\n
\n\n---\n\n## Why Porcupine\n\nPorcupine does not treat autonomy as all-or-nothing. You choose how much it may do before asking.\n\n| | Porcupine |\n|---|---|\n| **Safe autonomy** | Ask, Normal, and Auto modes let you choose the permission boundary. Normal asks on flagged actions; Auto applies a fail-closed safety gate. Hardline destructive actions remain blocked. |\n| **End-to-end work** | Porcupine reads the real project, chooses tools and skills, edits files, runs checks, recovers from failures, and reports evidence instead of stopping at a plausible answer. |\n| **Native-first** | It works on your computer with your tools and files by default. Gondolin, Docker, and OpenShell isolation remain opt-in when you want a stronger boundary. |\n| **Parallel execution** | Context-isolated sub-agents can research, inspect, implement, and review in parallel. Web of Thoughts lets them coordinate live. |\n| **One session, more surfaces** | Continue the same attended session from the terminal, Telegram, Discord, or iMessage. Use headless and server modes for scripts, CI, IDEs, and clients. |\n| **Open capability system** | Tools and skills live in 18 capability stacks. Extend Porcupine through Agent Skills, MCP, TypeScript extensions, packages, prompts, themes, and custom providers. |\n\n## Start in 60 seconds\n\nRequires **Node.js 22.19+**.\n\n```bash\nnpm install -g @porcupineai/porcupineai\nporcupine\n```\n\nThen connect a provider inside the TUI:\n\n```text\n/login cline\n/model\n/guide\n```\n\nCline provides a free API route. Select `cline/deepseek/deepseek-v4-flash` from `/model`, or connect another supported provider with `/login`.\n\nGive it a real goal:\n\n```text\nReview this repository, explain how it works, run its checks, and make the safest high-impact improvement you can verify.\n```\n\nPorcupine decides whether the turn needs a direct answer, tools, a skill, a plan, or parallel workers. It continues until the requested result is real or a genuine decision requires you.\n\n\n If Porcupine helps you do real work, a GitHub star helps more people find it.\n
\n\n\n GitHub ·\n npm ·\n Releases ·\n MIT License\n
\n\n\n ![\"Follow](\"https://img.shields.io/badge/X-%40SyedAbdurR2hman-000000?style=flat-square&logo=X&logoColor=white\"){kind=icon}