Cloud Atlas AI core stack for OpenCode - ba, wm, and superego in one package
npm install @cloud-atlas-ai/bottleOne package, full stack: ba (task tracking), wm (working memory), and superego (metacognition) for OpenCode.
``bash`
npm install @cloud-atlas-ai/bottle
Add to your opencode.json:
`json`
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@cloud-atlas-ai/bottle"]
}
Tools:
- ba-init - Initialize ba for a projectba-status
- - Show current tasks and countsba-quickstart
- - Quick reference guide
Requires: ba binary (install instructions)
Tools:
- wm init - Initialize working memorywm show state
- - View accumulated knowledgewm compile
- - Get relevant context for current taskwm distill
- - Extract knowledge from recent work
Requires: wm binary (install instructions)
How it works: A soft hint in the system prompt tells the LLM about wm. When the model needs context, it calls the wm tool. Similar to superego's "pull mode."
Tools:
- superego init - Initialize superegosuperego status
- - Check if enabledsuperego disable/enable
- - Toggle evaluationsuperego remove
- - Remove from project
How it works: Evaluates sessions when idle. If concerns found, injects feedback into the conversation.
1. Install bottle:
`bash`
npm install @cloud-atlas-ai/bottle
2. Add to opencode.json:
`json`
{
"plugin": ["@cloud-atlas-ai/bottle"]
}
3. Install binaries (ba and wm require them):
`bash
# ba
brew install cloud-atlas-ai/ba/ba
# or: cargo install ba
# wm
brew install cloud-atlas-ai/wm/wm
# or: cargo install wm
`
4. Initialize in your project:
Ask OpenCode to initialize each tool:
- "use ba-init to set up task tracking"
- "use wm init to set up working memory"
- "use superego init to set up metacognition"
(no per-prompt hooks available)
- Why: OpenCode doesn't have an equivalent to Claude Code's UserPromptSubmit hook
- Benefit: Preserves relevance filtering, avoids token bloat$3
✅ Same "pull mode" behavior - evaluates on session idleIndividual Plugins
If you only want one tool, install from their respective repos:
- ba-opencode
- wm-opencode
- superego-opencode
Architecture
Bottle is a meta-package that depends on the individually published plugins:
-
ba-opencode - Task tracking plugin
- wm-opencode - Working memory plugin
- superego-opencode - Metacognition pluginEach plugin can be published and versioned independently. Bottle simply re-exports them for convenience.
Each plugin:
- Provides OpenCode tools
- Injects soft hints via
experimental.chat.system.transform
- Registers event hooks where needed (superego uses session.idle`)MIT