What do you want to do?
3 use cases
-
Run one chat assistant across a project folder
Install Spynel and talk to one assistant that coordinates your coding harnesses in a single terminal chat.
- Spynel
- Claude Code
- Codex
- Work and operations
- Intermediate
View prompt
Using the spynel repo at agent0ai/spynel, install Spynel in <project-directory> and start it with `spynel` from that folder. Expected output: a running Spynel terminal chat bound to <project-directory>. Verify that `/config` opens and that a test message gets a reply from the assistant.
-
Keep project tasks and goals in readable markdown
Store tasks, goals, decisions, and status as markdown that any AI harness can inspect.
- Spynel
- Claude Code
- Codex
- Work and operations
- Intermediate
View prompt
Using the spynel repo at agent0ai/spynel, read docs/tasks-and-goals.md and start Spynel in <project-directory>. Expected output: markdown files holding goals, tasks, decisions, and status for that project. Verify that the files open as plain markdown and that a second AI harness can read the current task status from them.
-
Message your project assistant from Telegram or WhatsApp
Reach the same Spynel assistant from Telegram or WhatsApp when you are away from the terminal.
- Spynel
- Claude Code
- Codex
- Work and operations
- Advanced
View prompt
Using the spynel repo at agent0ai/spynel, follow docs/integrations.md to connect <Telegram or WhatsApp> to a Spynel instance running in <project-directory>. Expected output: a test message sent from the phone gets a reply from the same assistant. Verify that the reply matches the state shown in the terminal chat.
How to use Spynel
- Check you have what it needs: macOS or Linux for the curl install, or Node.js 18+ for the npm install; An existing coding harness such as Codex or Claude Code, since Spynel uses them to do the work; A project directory to run Spynel from.
- Open agent0ai/spynel on GitHub and read the README and license.
- Run
curl -LsSf https://spynel.agent-zero.ai/install.sh | shon macOS or Linux, or runnpm install -g spynelwith Node.js 18+. - Change into your project directory.
- Run
spynelfrom that directory. - Run
/configin the chat to complete setup.
These steps come from our top use case, Run one chat assistant across a project folder, which also has a copy-paste agent prompt.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers and power users who already use Codex or Claude Code and want one chat channel to coordinate their AI work across a project.
- Why it is hot
- LanguageGo
- Sourcegithub.com/agent0ai/spynel · Back to Hot repos
Requirements
- macOS or Linux for the curl install, or Node.js 18+ for the npm install
- An existing coding harness such as Codex or Claude Code, since Spynel uses them to do the work
- A project directory to run Spynel from
Add this badge to your README
Maintain Spynel? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/agent0ai-spynel/?utm_source=github&utm_medium=badge&utm_campaign=agent0ai-spynel)
HTML
<a href="https://dedupedai.com/use-cases/agent0ai-spynel/?utm_source=github&utm_medium=badge&utm_campaign=agent0ai-spynel"><img src="https://dedupedai.com/badge/agent0ai/spynel.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Spynel
What is Spynel?
Spynel is a lightweight terminal program with no AI inside that gives you one chat assistant and uses your existing coding harnesses such as Codex and Claude Code to do the work. It is an open-source project on GitHub: https://github.com/agent0ai/spynel.
Who is Spynel for?
Developers and power users who already use Codex or Claude Code and want one chat channel to coordinate their AI work across a project.
What can I do with Spynel?
3 use cases so far, for example: Run one chat assistant across a project folder; Keep project tasks and goals in readable markdown; Message your project assistant from Telegram or WhatsApp. Each has steps and a copy-paste agent prompt.
What do I need to run Spynel?
macOS or Linux for the curl install, or Node.js 18+ for the npm install; An existing coding harness such as Codex or Claude Code, since Spynel uses them to do the work; A project directory to run Spynel from.
What are alternatives to Spynel?
Other hot AI repos in Work and operations: Agents Office, Knowledge Work Plugins, Itsaplan, Endoplexity, Human Edge Agent Skills.
Is Spynel safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.