Bottle
Open Horizon Labs - One entry point for all the tools
Bottle provides the complete Open Horizon Labs stack for Claude Code, OpenCode, and Codex.
Quickstart
brew tap open-horizon-labs/homebrew-tap && brew install bottle
bottle install stable
bottle integrate claude_code # or: codex, opencode
Multiple Claude Code Directories
If you have multiple Claude Code directories (e.g., ~/.claude for personal use and ~/.claude-work for work), use the CLAUDE_CONFIG_DIR environment variable:
bottle integrate --list # shows all detected directories
CLAUDE_CONFIG_DIR=~/.claude-work bottle integrate claude_code # integrate specific directory
Then initialize in your project:
/bottle:init # Claude Code
$bottle init # Codex
bottle-init # OpenCode
This installs binaries, initializes .ba/, .wm/, .superego/, and creates AGENTS.md.
Ecosystem Vision
Bottle is part of the Open Horizon Labs ecosystem - tools that give you AI superpowers without surrendering your mind. The ecosystem has two delivery mechanisms serving different audiences:
Open Horizons (strategic layer - missions, guardrails, metis)
|
+-- Bottle (developer tools)
| CLI tools that augment AI coding assistants
| You use these TO BUILD software
|
+-- Memex (end user product)
Desktop app that IS the AI interface
Knowledge workers use this directly
Bottle tools augment Claude Code, OpenCode, and Codex with:
- Intentional grounding (wm/dive-prep) - Start sessions with relevant context
- Semantic recall (datasphere) - Search past knowledge
- Metacognitive oversight (superego) - Catch drift before it compounds
- Strategic alignment (oh-mcp) - Connect to your mission hierarchy
- Task tracking (ba) - Simple work management
- Remote orchestration (miranda) - Control sessions via Telegram
Memex implements the same concepts natively for end users:
- Dive = intentional grounding (native)
- Datasphere = semantic recall (native)
- Superego = metacognitive oversight (native)
- OH-local = strategic alignment (native)
The philosophy is shared: grounding prevents drift, recall surfaces relevant knowledge, oversight catches mistakes, and strategic context keeps you aligned with what matters.
We use bottle tools to build Memex. Memex will be the finished product for knowledge workers who want AI without the command line.
Tools
- ba - Task tracking for AI sessions
- wm - Working memory for automatic tacit knowledge extraction
- superego - Metacognitive advisor
- datasphere - Knowledge graph from Claude Code sessions (Claude Code only)
- oh-mcp - Open Horizons MCP for strategic alignment (Claude Code only)
- miranda - Telegram bot for remote orchestration (Claude Code only)
Platform-Specific Docs
For detailed installation and usage per platform:
What Each Tool Does
ba - Task Tracking
Simple, file-based task tracking. No server, no database.
Commands: /ba:init, /ba:quickstart, /ba:status
wm - Working Memory
Automatically captures tacit knowledge from sessions and injects relevant context.
Setup: Installs plugin + binary, works automatically
superego - Metacognition
Monitors Claude's work and provides feedback before finishing or making large changes.
Commands: /superego:init, /superego:review, /superego:prompt
datasphere - Knowledge Graph
Builds a searchable knowledge graph from Claude Code sessions, making insights from past sessions queryable.
Commands: /datasphere:init, /datasphere:setup
oh-mcp - Strategic Alignment
Connects Claude Code to Open Horizons for strategic context.
Setup: /oh-mcp:setup (requires OH account + API key)
miranda - Remote Orchestration
Telegram bot for running Claude sessions remotely.
Setup: Server component, see miranda docs
Updating
bottle update
See platform-specific docs for manual update commands.
Bespoke Bottles
Want to pin specific tool versions or create a team-shared configuration? Create a bespoke bottle:
bottle create mystack --from stable
# Edit ~/.bottle/bottles/mystack/manifest.json
bottle install mystack
