Skip to content
Back to search

stashbase

SkillWorks with CodexGitHub

An open-source, local-first writing workspace where you can write with Claude Code and Codex, drawing on your own sources and past work.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/liliu-z/stashbase with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/liliu-z/stashbase'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liliu-z--stashbase/badge.svg)](/listings/liliu-z--stashbase)

HTML

<a href="/listings/liliu-z--stashbase"><img src="/api/listings/liliu-z--stashbase/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 160 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # StashBase
  2. **Stash your notes and sources. Write with your agent.**
  3. [![Website](https://img.shields.io/badge/website-stashbase.ai-0a66c2.svg)](https://stashbase.ai)
  4. [![Release](https://img.shields.io/github/v/release/liliu-z/stashbase?label=release)](https://github.com/liliu-z/stashbase/releases/latest)
  5. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
  6. [![Discord](https://img.shields.io/badge/Discord-support%20%26%20chat-5865F2.svg?logo=discord&logoColor=white)](https://discord.gg/zsRZH4PTq9)
  7. StashBase is an open-source, local knowledge base for writing with AI agents.
  8. Your notes, PDFs, and docs stay in a folder on your computer, and Claude, Codex,
  9. or Antigravity works inside it with you.
  10. - 📝 **Side by side with your agent.** Your docs stay open beside the
  11. chat. When your agent edits one, `Review` shows each change inside the prose,
  12. so you can undo or keep it.
  13. - 🗂️ **Your knowledge base, kept up to date.** Ask your agent to file new material,
  14. update your notes, and link them back to their sources. It reads PDFs, Word
  15. documents, and scans too, with the text extracted on your computer.
  16. - 💬 **Bring the agent you already use.** Claude, Codex, and Antigravity run on
  17. your existing accounts, and StashBase charges nothing for them. Pick a persona
  18. or write your own to set the voice.
  19. ## Product Preview
  20. https://github.com/user-attachments/assets/4ba282a3-85d2-4a08-b7af-562a1e71e716
  21. ## Get Started
  22. **macOS 12+ (Apple Silicon and Intel)** and **Windows 10+ (x64)** are the primary
  23. platforms. Linux x86_64 Debian 12+ / Ubuntu 22.04+ is community-supported.
  24. On Intel Macs, local search and PDF/image text extraction require macOS 15+;
  25. older supported systems can still open projects and edit files. Agent runtime
  26. requirements may vary.
  27. On macOS, install with Homebrew:
  28. ```bash
  29. brew install --cask liliu-z/stashbase/stashbase
  30. ```
  31. Or [download the latest release](https://github.com/liliu-z/stashbase/releases/latest):
  32. | Platform | Download |
  33. |---|---|
  34. | macOS Apple Silicon | `StashBase-*-mac-arm64.dmg` |
  35. | macOS Intel | `StashBase-*-mac-x64.dmg` |
  36. | Windows x64 | `StashBase-*-win-x64.exe` |
  37. | Linux x86_64 | `StashBase-*-linux-amd64.deb` or `.AppImage` |
  38. See [Installation](docs/installation.md) for platform steps, updates, and
  39. troubleshooting.
  40. ### Start Writing
  41. 1. **Enter a project.** Open or create a local folder.
  42. 2. **Choose an agent.** Select Claude, Codex, or Antigravity and complete its
  43. setup with your provider account. If you can't use any of them, the built-in
  44. **Default Agent** is available as a fallback. Sign in to StashBase for its
  45. free monthly credits; [Plus and Pro](https://stashbase.ai/pricing/) add more.
  46. 3. **Talk it through.** Try: “I want to write a LinkedIn post about what I
  47. shipped this week. Interview me before drafting.”
  48. 4. **Draft and revise.** Ask your agent to draft the article, then review and
  49. refine it.
  50. Switch between `Chat` for the conversation and `Documents`, a file tree and
  51. editor that works like an IDE, but for writing. Both modes share the project and
  52. keep unfinished work when you switch.
  53. See [Using StashBase](docs/using-stashbase.md) for everyday document and search workflows.
  54. ## Explore the Gallery
  55. Explore how people organize files and write with agents. Copy a ready-made
  56. project or reuse its prompt to try a workflow with your own material.
  57. For example, in [Resume Builder](https://stashbase.ai/gallery/resume-builder/)
  58. the agent interviews you first, then writes a resume that shows what you
  59. actually did and tailors it to each job.
  60. [Explore the Gallery →](https://stashbase.ai/gallery/)
  61. ## Your Files and Your Data
  62. Your documents stay in local project folders. Removing a project from StashBase
  63. doesn't delete its files. Browsing, editing, previews, and keyword search work
  64. without an account. PDF and Word text extraction and OCR run locally, with required
  65. components downloaded on first use.
  66. Agent conversations send your prompts and relevant context to model services.
  67. Claude, Codex, and Antigravity use your provider accounts; the Default Agent connects
  68. through StashBase's hosted model gateway, which sends requests through OpenRouter
  69. to Claude Haiku 5.5 by default.
  70. **Search by meaning** requires your own OpenAI or OpenRouter key in
  71. `Settings → Advanced → Search by meaning`. It sends source text and search
  72. queries to your chosen embedding provider. Default Agent credits don't cover
  73. this service.
  74. Packaged builds and source runs share usage statistics and error diagnostics by default, excluding document
  75. and conversation content. You can turn this off in
  76. `Settings → General → Privacy`. See [Usage statistics](docs/usage-statistics.md) for details.
  77. ## Connect External Agents
  78. Agents in the built-in Chat connect to StashBase's tools automatically.
  79. To use an external MCP client, keep StashBase running and copy the connection
  80. configuration from `Settings → Advanced → External apps (MCP)` into that
  81. client. It can read, search, and edit supported files in the project you select.
  82. See [MCP Configuration](docs/mcp-configuration.md) for client examples,
  83. transports, and access settings.
  84. ## Build From Source
  85. Install Node.js 24.11.0+, pnpm, and Python 3.13 with venv support.
  86. See [Local Development](CONTRIBUTING.md#local-development) for platform dependencies.
  87. ```bash
  88. git clone https://github.com/liliu-z/stashbase
  89. cd stashbase
  90. pnpm install
  91. pnpm setup:python
  92. env -u ELECTRON_RUN_AS_NODE pnpm dev
  93. ```
  94. The launch command above uses POSIX shell syntax to clear an inherited
  95. `ELECTRON_RUN_AS_NODE`. On Windows, clear that variable in your shell before
  96. running `pnpm dev`.
  97. See [Contributing](CONTRIBUTING.md) for OCR setup, testing, and release guidance.
  98. ## Contributing
  99. StashBase is also an experiment in human-directed, AI-first development.
  100. Humans own product direction and trust decisions; AI helps connect design,
  101. implementation, review, and evidence. The
  102. [Project Maintenance Model](MAINTENANCE.md) describes that working loop.
  103. Small focused PRs are preferred. Open an issue before larger changes so scope
  104. and direction can be discussed first.
  105. - [Contributing guide](CONTRIBUTING.md): development and validation.
  106. - [Product design](design-docs/README.md): intent, workflows, and contribution areas.
  107. - [Engineering contracts](code-review/README.md): ownership, invariants, and review.
  108. ## Feedback
  109. [Report an issue](https://github.com/liliu-z/stashbase/issues) or
  110. [join the Discord community](https://discord.gg/zsRZH4PTq9) for support and discussion.
  111. ## About
  112. StashBase is an independent open-source project built by
  113. [Bing Wu](https://www.linkedin.com/in/bingwu-cmu/) and
  114. [Li Liu](https://www.linkedin.com/in/cmuliliu/).
  115. Licensed under [Apache 2.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.