Crush

Crush, Charm's terminal coding agent, reads your rules and saves what it learns to your memory.

Connects with
Config file
Takes work from @alwen
No
Plans
Every plan
Website
github.com/charmbracelet/crush

What changes

  1. Codes with your rules applied
  2. Searches your notes for context
  3. Saves what it learns where your other tools can see it

Set up

  1. Add Alwen to crush.json, as shown here. Keep oauth set to true.

  2. Crush opens your browser; click Allow on the Alwen page.

crush.json
{
  "mcp": {
    "alwen": { "type": "http", "url": "https://api.alwen.ai/mcp", "oauth": true }
  }
}

What it reads and writes

Every write is a commit signed by Crush, so you can see what it added and undo it.

Reads

  • Your rules and profile, once per session
  • Notes that match what you're working on
Your vaultyou/alwen-vault

Writes

  • What it learns, into inbox/crush/ for the tidy-up to file
  • Decisions, straight into journal/
  • Suggested rules, which wait for you to confirm

Give every AI the same memory.

Start free