magpie

CLI reference

Every magpie subcommand.

The magpie binary talks to the same SQLite database as the desktop app and the MCP server -- whichever one you use, they all see the same queue.

Captures

magpie add "some text"              # capture into the stream
magpie list                         # the stream, most recent first
magpie list --now                   # just Now
magpie list --limit 100
magpie search "retry logic"         # full-text search
magpie done <id>                    # mark a capture done

Drain -- piping work to an agent CLI

magpie drain --tag refactor --limit 3 | claude -p

Prints Now items (optionally filtered by tag) and marks each one done as it's printed. This is the CLI's job, not MCP's -- MCP is for an agent to pull work interactively; drain is for scripting a one-shot push.

Export

magpie export --format json
magpie export --format md

Prompt packs

magpie pack add github:someone/agent-prompts   # github: shorthand
magpie pack add https://example.com/pack.git   # any git URL
magpie pack add ./a-local-pack                 # local path, for testing a pack

magpie pack list                    # every imported pack
magpie pack templates <pack_id>     # one pack's templates

Re-running pack add against the same source updates that pack's templates in place. See Templates and packs for the manifest format.

MCP server

magpie serve-mcp

Runs the MCP server over stdio until the client disconnects, then releases every lease that session held. This is what an agent host spawns as a subprocess -- see MCP integration for registering it with Claude Code or Cursor.

Screenshots and OCR

Region capture with on-device text recognition, so a screenshot is as searchable as a note.

MCP integration

Register magpie with Claude Code, Cursor, or any MCP-speaking agent host.

On this page

CapturesDrain -- piping work to an agent CLIExportPrompt packsMCP server