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-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Fergana-Labs/stash.

Contents

Discovered from source

Agents 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 doCommandWhat you give the user
Share one file (publicly)stash upload <path> --jsonthe returned app_url
Upload a folder / project into your Stashstash upload <path> --jsonthe returned app_url
Publish a curated bundle as one shareable thingstash upload <path> --skill "<title>" --jsonthe returned url
Create a fresh skill folderstash skills create "<name>" --public --jsonthe returned folder
Share a coding session (transcript + files)stash share (this one), or --session "<title>"the returned url
Use a public Skill in this agentstash skills install <slug>the installed ~/.claude/skills path
Sync your Stash skills with local agent skillsstash skills syncruns 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 --json flag 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

KeyDefaultDescription
api_endpointhttps://joinstash.aiStash 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.

CommandDescription
stash signinSign in + first-run setup (re-run the wizard anytime: stash setup)
stash settingsInteractive settings page (streaming, scope, endpoint, …)
stash stopPause 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 stash CLI (uv tool install stashai). Every hook is the stable command stash 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