mymind CLI

Remember everything. Use it anywhere.

mymind brings your saved notes, bookmarks, articles, images, documents, and references to your terminal and your AI tools.

Save things. Find them later. Let your agents search your mind without making you copy paste context.

Install

The easiest way:

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | sh

This installs both:

• mymind - the command line app
• mymind-mcp - the MCP server for agents

It can also set up MCP for the tools it finds on your machine.

Connect your mind

Create a mymind access key, then run:

mymind auth set-key YOUR_KID YOUR_BASE64_SECRET
mymind doctor

That is it.

Install with Homebrew

brew install nawwwal/whimsies/mymind

Update later with:

brew upgrade nawwwal/whimsies/mymind

Update

For existing installs, use the native updater:

mymind update

It detects Homebrew, curl, source, and unknown installs. Homebrew installs delegate to brew upgrade nawwwal/whimsies/mymind. Curl installs rerun the repeat-safe installer for the detected install directory with MCP setup skipped, so existing MCP entries keep pointing at the same mymind-mcp path.

Use with agents

Let the installer find your agent apps:

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=all sh

Or choose one:

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=codex sh
curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=claude-code sh
curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=cursor sh

For scripts and agent-led installs:

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | \
  MYMIND_KID=YOUR_KID \
  MYMIND_SECRET=YOUR_BASE64_SECRET \
  MYMIND_SETUP_MCP=codex,claude-code,cursor \
  sh

Use with Claude Desktop

Download the .mcpb for your computer from the latest release.

Double-click it.

Claude Desktop will ask for:

• MYMIND_KID
• MYMIND_SECRET

MCPB bundles are published for Apple Silicon macOS and Windows x64.

Use with Claude Code

For the focused skill:

npx skills add nawwwal/mymind -g

Then use:

/mymind what you want to find

For MCP instead:

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=claude-code sh

Use with Codex

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=codex sh

Then run /mcp in Codex and check that mymind is active.

The main tool is search.

Use with Cursor

curl -fsSL https://raw.githubusercontent.com/nawwwal/mymind/main/install.sh | MYMIND_SETUP_MCP=cursor sh

What you can do

Find anything

mymind search "reading list"
mymind search "article about memory" --semantic --rerank
mymind search "design notes" --json

Search returns useful result summaries: title, score, type, URL, tags, and dates when mymind has them. Use --matches-only when you only want raw ranked IDs.

Save a link

mymind objects create \
  --url "https://example.com/article" \
  --tags "reading,research"

Save a note

mymind objects create \
  --content "Follow up on the search UX." \
  --title "Search UX note" \
  --tags "notes,work"

See what you saved

mymind objects list --limit 20
mymind objects get <object_id>
mymind objects content get-object <content_object_id>

Keep a local copy

mymind sync --since 30d
mymind search "design notes" --data-source local

Organize when you want to

You do not need folders to find things.

But if you want structure:

mymind tags
mymind objects tags add-object <object_id> --tags "reading,research"

mymind spaces create --name "Research"
mymind spaces objects add-to-space <space_id> <object_id>

For agents and scripts

Use --agent when another tool is calling mymind.

mymind agent-context --pretty
mymind which "save a URL" --json
mymind search "renewal notes" --agent
mymind search "renewal notes" --agent --select id,title,url,score

Useful flags:

• --json gives structured output
• --select id,title,url keeps only the fields you need
• --dry-run shows what would happen
• --deliver file:results.json writes output to a file

Find the right command:

mymind which "search objects"
mymind --help
mymind <command> --help

Other install options

Pre-built binaries

Download mymind and mymind-mcp from the latest release.

Pre-built archives are published for Apple Silicon macOS and Windows x64.

On macOS:

xattr -d com.apple.quarantine mymind mymind-mcp 2>/dev/null || true
chmod +x mymind mymind-mcp
sudo mv mymind mymind-mcp /usr/local/bin/

On Windows, unzip the archive and add the folder to your Path.

Go developers

Only use this if you already have Go installed:

go install github.com/nawwwal/mymind/cmd/mymind@latest
go install github.com/nawwwal/mymind/cmd/mymind-mcp@latest

From source

make build-all

Install for Hermes

From the Hermes CLI:

hermes skills install nawwwal/mymind --force

Inside a Hermes chat:

/skills install nawwwal/mymind --force

Install for OpenClaw

Tell your OpenClaw agent:

Install the mymind skill from https://github.com/nawwwal/mymind.

Configuration

Config lives at:

~/.config/mymind/config.toml

You can also use environment variables:

export MYMIND_KID="your-kid"
export MYMIND_SECRET="your-base64-secret"

Troubleshooting

Check the connection:

mymind doctor

If auth fails, set the key again:

mymind auth set-key YOUR_KID YOUR_BASE64_SECRET

If a command feels unclear:

mymind which "what you want to do"
mymind <command> --help