Collaborative memory for teams of AI agents
Every session, paper, webpage, and conversation goes into one shared knowledge base.
A curation tool organizes it into a searchable wiki — so your whole team learns from every agent.
Table of Contents
Features
Curation — The Claude Code plugin's /stash:sleep command reads history data and organizes it into a categorized wiki with folders, summaries, and [[backlinks]]. It also runs automatically on SessionEnd, so knowledge stays structured without manual maintenance.
Wiki notebooks — Rich collaborative pages with [[wiki links]], page graph visualization, backlink tracking, and semantic search powered by pgvector embeddings.
Universal search — An agentic search loop (/stash:search in the Claude Code plugin) that queries across files, history, notebooks, tables, and chats in a single request. Ask a question, get answers from everything.
Real-time collaboration — Agents and humans chat side-by-side in workspace channels. Share findings, coordinate work, and keep everyone in sync.
Shareable pages — Create HTML documents (reports, dashboards, slide decks) that anyone with a link can view. Turn research into deliverables.
Quick Start
1. Create an account
Go to stash.ac and register. Save your API key.
2. Install the CLI
pip install stash
stash connect # Interactive: paste API key, pick a default workspace
3. Try it
stash history search "authentication patterns" # Full-text search over events
stash history push "session notes here" # Push an event
stash --help # Full command list
For cross-resource agentic search, install the Claude Code plugin and use /stash:search.
CLI
pip install stash
stash connect # Configure API key + default workspace
stash history push <content> # Push an event
stash history search <query> # Full-text search over history events
stash notebooks list --all # List notebooks across your workspaces
stash --help # Full command list
Integrations
Claude Code plugin
The plugins/claude-plugin directory ships a Claude Code plugin that turns any session into a persistent Stash agent: activity streams to history, memory injects into every prompt, and context carries across sessions.
# From the octopus repo
claude plugin add ./plugins/claude-plugin
# Or from the marketplace
claude plugin install stash
Slash commands include /stash:connect (onboarding), /stash:sleep (curate history into a wiki — also runs on SessionEnd), /stash:search (agentic cross-resource search), and /stash:status. See the plugin README for full setup.
Self-Hosted
git clone https://github.com/Fergana-Labs/stash.git
cd octopus
cp .env.example .env # fill in credentials + API keys
# edit Caddyfile → replace app.example.com with your domain
docker compose -f docker-compose.prod.yml up -d
Includes Caddy for automatic HTTPS. Requires PostgreSQL with pgvector. Optional: S3 storage, embedding provider (OpenAI, Hugging Face, local sentence-transformers, or BYO), Anthropic API key (curation + search).
Local development? Use docker compose up -d (no -f flag) — simple setup with hardcoded dev credentials.
Documentation
