
stash
Connect Claude Code to Stash — stream activity to history, inject agent memory, collaborate in workspaces.
- version
- 0.1.560
- GitHub stars
- 343
Install
/plugin install stash@stash-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add Fergana-Labs/stash.
Contents
Discovered from sourceAgents 2
Stash Plugin
IMPORTANT: You have the stash CLI on your PATH. When the user mentions "Stash", their Stash, their activity, or transcripts, always use this CLI. Run stash --help to see all available commands.
What a Skill is
A Skill is a special folder — one containing a SKILL.md — holding related artifacts (pages, files, tables) that shares like any folder and gains a public URL when published. It is the unit you reach for when you want to publish a collection of things together — a project writeup with its supporting files, a research thread with its sources, a session transcript plus the files it produced.
A Skill is not a wrapper around every single file you happen to share. One-item Skills clutter Discover and your Stash sidebar, and they defeat the model.
Decision rule for sharing
| What you want to do | Command | What you give the user |
|---|---|---|
| Share one file (publicly) | stash upload <path> --json | the returned app_url |
| Upload a folder / project into your Stash | stash upload <path> --json | the returned app_url |
| Publish a curated bundle as one shareable thing | stash upload <path> --skill "<title>" --json | the returned url |
| Create a fresh skill folder | stash skills create "<name>" --public --json | the returned folder |
| Share a coding session (transcript + files) | stash share (this one), or --session "<title>" | the returned url |
| Use a public Skill in this agent | stash skills install <slug> | the installed ~/.claude/skills path |
| Sync your Stash skills with local agent skills | stash skills sync | runs automatically at session start; two-way |
The default of stash upload is no Skill — files land in a folder in your Stash and you hand back the app_url. Add --skill "<title>" only when you're deliberately publishing a bundle.
Run stash prompts agent-guidance to reprint this rule mid-session.
Stash CLI
Most things are plain stash CLI subcommands. Always use --json for machine-readable output when parsing results.
Everything as a filesystem
stash ls renders everything Stash can reach as one tree — your files, session transcripts, and every connected integration (GitHub, Slack, Gong, Gmail, Drive, Notion, …). When asked what you have access to, run it and show the tree.
stash ls # Everything as a filesystem
stash ls gong # One integration's contents
stash ls my-repo/docs # Drill into a directory
stash ls -L 3 --json # Deeper tree, machine-readable
Virtual filesystem
Use stash vfs when you want to browse Stash like a filesystem without mounting anything into the OS. It accepts bash-shaped commands over the virtual Stash tree:
stash vfs ls /
stash vfs "find /me -maxdepth 3 -type f"
stash vfs "rg \"query\" /me"
stash vfs "cat '/me/README.md'"
Plugin control
stash signin # Sign in + first-run setup (auth, recording, hooks)
stash setup # Re-run the setup wizard anytime
stash settings # Interactive settings page (streaming, scope, endpoint, …)
stash stop # Pause session recording across every plugin (stash start resumes)
Memory
stash memory ls # The Memory wiki tree with ids
stash memory write "Topic/Page" --content "…" # Create or update a wiki page (stdin for long bodies)
stash memory --curator off # Turn the nightly cloud curator off (on to resume)
Files, history, tables
Files
stash vfs "tree /me/files" # Show folders and pages
stash vfs "ls /me/files" # List your pages
stash vfs "find /me -name '*.md'" # List your pages
stash files create-folder "name" # Create a folder
stash files add-page "title" --content "markdown content"
stash vfs "cat '/me/files/<page>.md'" # Read a page
stash files edit-page <page_id> --content "new content"
History (Agent Event Logs)
stash sessions agents # List distinct agent names
stash sessions push "text" --agent <name> --type <event_type>
stash vfs "cat '/me/sessions/_index.jsonl'" # Query events
stash search "query" # Full-text search
Tables
stash vfs "cat '/me/tables/_index.jsonl'" # List tables
stash tables search <table_id> "query" # Search rows
Tips
- Use
--jsonflag on any command for JSON output - The CLI reads config from
~/.stash/config.json
Stash Plugin for Claude Code
Turn any Claude Code session into a Stash agent. Every prompt, tool use, assistant message, and artifact streams to your Stash history.
Quick Start (2 minutes)
uv tool install stashai
stash signin
stash signin opens your browser to sign in (or create an account), saves
your credentials to ~/.stash/config.json, detects Claude Code, and installs
this plugin via the marketplace — no API key to copy anywhere.
To install the plugin by hand instead:
claude plugin marketplace add Fergana-Labs/stash
claude plugin install stash@stash-plugins
The manual path still needs stash signin once for auth; the plugin reads
~/.stash/config.json when its own config values are unset.
You're done
Every Claude Code session now automatically:
- Streams the user's prompts to your Stash history
- Streams tool usage (edits, commands, writes) to your Stash history
- Uploads the assistant message, transcript, and artifacts when you stop
This is set-and-forget. Config persists — new sessions work automatically with no re-configuration.
Configuration Reference
| Key | Default | Description |
|---|---|---|
api_endpoint | https://joinstash.ai | Stash backend URL |
api_key | (required) | Your API key |
agent_name | (required) | Agent name (any string) |
What Happens Each Session
SessionStart ──→ Record session ID
UserPromptSubmit ──→ Push user_message event to your Stash history
PostToolUse ────→ (async) Push tool_use event to your Stash history
(Read, Glob, Grep excluded — too noisy)
Stop ───────────→ Push session_end event (tool count, files changed)
Commands
Everything is a stash CLI subcommand — there are no slash commands.
| Command | Description |
|---|---|
stash signin | Sign in + first-run setup (re-run the wizard anytime: stash setup) |
stash settings | Interactive settings page (streaming, scope, endpoint, …) |
stash stop | Pause session recording across every installed plugin (stash start resumes) |
The plugin also gives Claude access to the rest of the stash CLI. Key commands:
stash vfs "find /me -maxdepth 3 -type f" # Browse Stash like a filesystem without an OS mount
stash vfs "rg \"database migration\" /me" # Search the virtual Stash tree
stash vfs "cat '/me/README.md'"
stash search "database migration" # Full-text search events
stash vfs "cat '/me/sessions/_index.jsonl'" # Recent events
stash vfs "find /me -name '*.md'" # List all pages
Prerequisites
- The
stashCLI (uv tool install stashai). Every hook is the stable commandstash hook run claude <event>: the hook scripts ship inside the stashai package and run under its Python, so scripts and library never drift apart.
Sponsors
Details
- Marketplace
- Fergana-Labs/stash
- Source
- plugins/claude-plugin
- Author
- Fergana Labs
- Category
- Productivity