Muse

Your muse is an AI that thinks like you, derived from your conversation history across Claude Code, Kiro, and OpenCode.

Install

go install github.com/ellistarn/muse@latest

Getting Started

muse compose              # discover conversations and compose muse.md
muse ask "your question"  # ask your muse directly
muse eval                 # evaluate the muse against a base model
muse listen               # start MCP server
muse show                 # print muse.md
muse show -o muse.pdf     # export as PDF

Work directly with your muse as agent:

// OpenCode — ~/.config/opencode/opencode.json
{ "instructions": ["~/.muse/muse.md"] }

Or run as an MCP server so other agents can work with your muse:

{
  "mcpServers": {
    "${USER}": {
      "command": "muse",
      "args": ["listen"]
    }
  }
}

Sources

Local sources are activated automatically on first run: Claude Code, OpenCode, Codex, Kiro.

Network sources require explicit opt-in:

muse add github-issues              # GitHub issues (requires gh auth)
muse add github-prs                 # GitHub PRs (requires gh auth)
muse add slack                      # Slack (set MUSE_SLACK_TOKEN and MUSE_SLACK_WORKSPACE)
muse remove github-prs              # stop including a source
muse sources                        # see what's active

Sources are remembered across runs — muse compose processes whatever is active.

Import Plugins

Import external data from proprietary systems using plugins — executables named muse-{name} on $PATH:

muse import code-reviews            # run muse-code-reviews plugin
muse import internal-chat           # run muse-internal-chat plugin
muse import                         # re-import all previously imported sources

Plugins receive MUSE_OUTPUT_DIR and write Conversation JSON files plus a .muse-source.json metadata file. See examples/muse-test-plugin/ for a reference implementation and designs/010-import.md for the full design.

Storage

By default, data is stored locally at ~/.muse/. To use an S3 bucket instead (for sharing across machines or hosted deployment), set the MUSE_BUCKET environment variable:

export MUSE_BUCKET=$USER-muse

muse sync local s3                  # push everything to S3
muse sync s3 local conversations    # pull conversations from S3

Run muse --help for detailed usage.