terminal multi-agent system

Your terminal.
Now thinks.

Octopus understands plain English and executes real tasks — emails, files, shell commands, git operations, web search. No GUI. No complex setup. Just your terminal.

npx octopus-agent
octopus — terminal ai agent
model llama-3.3-70b-versatile via groq
platform windows / macos / linux
memory last 10 messages (sqlite)

Five tentacles.
Infinite tasks.

Each tentacle is powered by a specialized AI agent. Octopus plans tasks, selects the right agents, and coordinates execution automatically.

shell

Run any terminal command in plain English. Cross-platform — Windows, Mac, Linux.

show my running processes
what is my IP address
list files in downloads
📁
file

Read, write, search, and list files. Understands paths, home directory, and nested search.

read ~/notes.txt
write my ideas to ~/ideas.txt
search for invoice files
✉️
email

Send emails via Gmail. Octopus writes the subject and body from your description.

email john that meeting is cancelled
send priya the project update
email team about deadline change
🌐
web

Scrape, screenshot, summarize, and search the web. Powered by Playwright + Google News RSS.

search for latest AI news
summarize https://dev.to/post
screenshot github.com/profile
git

AI-powered git operations — smart commits, PR descriptions, standup generator, safety checks and more.

commit my changes with a good message
generate my standup
write a PR description
is it safe to push
am I ahead or behind remote
🧠
multi-agent

Complex tasks are broken into smaller steps and delegated across specialized agents automatically.

research and summarize AI startups
analyze repo and generate PR
check the repo status and mail the manager about the status of teh project

Everything else
has a catch.

ChatGPT answers but can't act. n8n acts but needs a GUI. Shell scripts act but need you to write them. Octopus just does it.

01
no GUI required

Everything runs in your terminal. If you live in the command line, Octopus lives there too.

02
cross-platform

Detects Windows, Mac, or Linux at runtime and generates the right commands for your OS automatically.

03
memory that persists

Remembers the last 10 messages across sessions using local SQLite. Context survives restarts.

04
safety first

Dangerous commands require confirmation. Destructive shell operations are blocked entirely.

05
blazing fast

Powered by Groq — Llama 3.3 70B at ~300ms. Intent parsed and executed before you finish reading.

06
open and extensible

Add new tentacles in one file. The plugin architecture is simple by design — no framework needed.

07
AI git operations

Writes commit messages from your diff, generates standups, checks for leaked secrets before push, and explains what changed in plain English.

08
multi-agent orchestration

Planner, researcher, git, and execution agents collaborate automatically to solve larger tasks that a single agent cannot handle efficiently.

How it stacks up.

Octopus occupies a gap that nothing else fills — terminal-native, action-oriented, no setup friction.

tool terminal-native no GUI setup AI Powered email actions web scraping multi-agent any user
ChatGPT / Claude
n8n / Zapier
Claude Code ✗ devs only
Shell scripts ✗ devs only
🐙 octopus ✓ everyone

get started

One command.
That's it.

A complete multi-agent AI system running directly inside your terminal.No account. No dashboard.

$ npx octopus-agent


get a free groq api key at console.groq.com → run setup wizard → you're in