Introducing the ContextStore CLI

Your context repository might span multiple spaces — Product, Marketing, Engineering. But when you're working in a coding agent, it only sees the current project directory. Your product vision is in one space. Your brand guidelines are in another. Your engineering architecture docs are in a third. The agent has no idea any of it exists.

The ContextStore CLI fixes this. Run cstore from any directory and your agent can browse, search, read, and write documents across all your spaces. No folder permissions to grant. No paths to remember. Just context, available everywhere.

A quick tour

Install ContextStore and the CLI is included. Run cstore help to see what's available. Here are the commands you'll use most:

List your spaces and documents:

cstore ls                      # list all spaces
cstore ls Product --stats      # list docs in a space with word counts
cstore tree Product            # show the full folder structure

cstore ls                      # list all spaces
cstore ls Product --stats      # list docs in a space with word counts
cstore tree Product            # show the full folder structure

Read documents:

cstore read Product/vision.md           # full document
cstore read Product/roadmap.md --head 20  # just the first 20 lines

cstore read Product/vision.md           # full document
cstore read Product/roadmap.md --head 20  # just the first 20 lines

Search across everything:

cstore search "onboarding"              # full-text search
cstore search "PIX-\d+" --regex         # regex search
cstore search "auth" --folder Product   # scope to a folder

cstore search "onboarding"              # full-text search
cstore search "PIX-\d+" --regex         # regex search
cstore search "auth" --folder Product   # scope to a folder

Concatenate documents for bulk context:

cstore cat Product/ --headers   # dump all docs in a folder

cstore cat Product/ --headers   # dump all docs in a folder

Track tasks:

cstore tasks Product/ --pending   # show incomplete checkboxes
cstore check Product/roadmap.md "Launch beta"  # mark one done

cstore tasks Product/ --pending   # show incomplete checkboxes
cstore check Product/roadmap.md "Launch beta"  # mark one done

The CLI also supports creating, editing, moving, and deleting documents. Run cstore help <command> for details on any command.

Why this matters for agents

The real power of cstore is what it enables for your AI agent. When an agent has access to cstore, it can pull context from any space without you having to set up folder access or copy files around. Working on a feature in your codebase? The agent can cstore read Product/vision.md to understand why the feature matters. Writing marketing copy? It can cstore search "brand voice" --space Marketing to find your style guide.

This works because cstore operates like git — it walks up from the current directory looking for a .contextstore/settings.yml file, and it can target any space by name with the --space flag. Your agent doesn't need to know where files live on disk.

Get started

The CLI ships with ContextStore but needs a one-time install. Open ContextStore, click the gear icon in the lower left to open Settings, then click the CLI tab. Click Install to open the install dialog.

The dialog walks you through three steps: copy the install command, paste it into Terminal (you'll be prompted for your password), and verify with cstore help.

Once installed, try:

cstore help

cstore help

You should see a list of all available commands. From there, try reading a document or searching for a term. Once you're comfortable, tell your agent about it. Add a note to your AGENTS.md that cstore is available, what spaces it can access, and which documents matter most — like your Vision, Roadmap, and key Specs. That's all the agent needs to start pulling in the right context on its own.