Thoth - Root-level life orchestrator for OpenCode. Unified AI chief of staff combining Sisyphus execution quality, Personal-OS rhythms, and Thoth relationship model.
npm install thoth-plugin> Life orchestration system and OpenCode plugin for managing work, personal life, and technical projects.
Thoth is a knowledge-based life operating system that acts as your chief of staff. Unlike traditional coding assistants, Thoth is designed to support, guide, and mentor — not just write code.
---
Thoth is the convergence of multiple OpenCode innovations. It is built upon and integrates with:
- OpenCode: The foundational AI plugin architecture.
- OhMyOpenCode: The "batteries-included" framework that inspired Thoth's distribution model.
- Personal-OS: The knowledge base structure and "Circle System" methodology.
- OpenProse: The declarative workflow language used for complex skills like morning-boot.
- Vibe-Kanban: Integrated task management visualization and tracking.
Thoth acts as the Root Orchestrator, coordinating these tools into a unified "Operating System for Life".
---
``bash`
npm install -g thoth-plugin
Then add to your OpenCode config (~/.config/opencode/opencode.json):
`json`
{
"plugin": [
"thoth-plugin"
]
}
`bashCreate a new knowledge base with default structure
npx thoth-plugin init
$3
Create
:`json
{
"enabled": true,
"knowledge_base": "/path/to/your/thoth-kb"
}
`---
LLM Installation Instructions
If you're an AI assistant helping a user install Thoth, see the HTML comment above for step-by-step instructions.
---
Features
- Four Hemispheres: Organized knowledge across work, life, coding, and system (kernel)
- Depth-Based Specialization: Agent persona adapts based on where you are in the knowledge base
- Smart Delegation: Routes tasks to specialized sub-agents (Work Master, Life Master, Code Master)
- Permission System: Critical actions require explicit approval
- Knowledge Persistence: Learns and remembers across sessions
- Skill System: Automatic skill triggers for common workflows (morning boot, email triage, etc.)
Depth-Based Specialization
Thoth's personality and expertise change based on your current directory:
| Depth | Example | Persona |
|-------|---------|---------|
| 0 |
| Pure Chief of Staff |
| 1 | /thoth-kb/work/ | Executive COS (crisp, P0-focused) |
| 1 | /thoth-kb/life/ | Personal Consultant (warm, Socratic) |
| 2 | /thoth-kb/work/projects/ | Project Portfolio Manager |
| 3 | /thoth-kb/work/projects/x/ | Deep Expert on Project X |Structure
`
thoth-kb/ # Your knowledge base
├── kernel/ # System config, memory, standards
├── work/ # Professional life
├── life/ # Personal life
├── coding/ # Technical projects
└── .opencode/skill/ # Custom skills
Skills
Thoth includes built-in skills that trigger automatically based on your intent:
| Trigger Phrases | Skill |
|-----------------|-------|
| "start my day", "morning routine", "prepare me for the day" | morning-boot |
| "end of day", "wrap up", "evening summary" | evening-close |
| "check my email", "email triage" | mail-triage |
| "process meeting notes", "drill meeting" | post-meeting-drill |
| "check slack", "slack mentions" | slack-pulse |
| "brain dump", "capture this" | thought-router |
| "draft an email", "write email to" | email-draft |
$3
bash
List all available skills
npx thoth-plugin skill listUpdate skills to latest version (interactive)
npx thoth-plugin skill update
`The
command:
- Compares your local skills with the latest package
- Shows what's new, updated, or locally modified
- Prompts for confirmation before each update
- Offers to help you contribute back if your local version is more advanced$3
`
thoth-core (this repo) thoth-kb (your knowledge base)
├── defaults/skill/ ──────> ├── .opencode/skill/
│ ├── skill-generator/ copy │ ├── skill-generator/
│ ├── email-draft/ on │ ├── email-draft/
│ ├── morning-boot/ init │ ├── morning-boot/
│ └── ... or │ └── my-local-skill/
└── src/cli.ts update └── ...
Key principles:
- Source of truth:
is canonical
- All skills are public: Personalization via knowledge base files, not skill forks
- Distribution via npm: Skills ship with the package
- Contribute back: Local improvements can be PR'd to thoth-core$3
Skills follow a TDD-inspired process (RED-GREEN-REFACTOR):
1. RED: Test baseline behavior without the skill (using subagent)
2. GREEN: Write minimal skill that fixes the failure
3. REFACTOR: Close loopholes, add to rationalization table
Use the
skill-generator skill:
`
/skill-generator
Skills follow a modular architecture with three components:
skill-name/
├── SKILL.md # Workflow logic (required)
├── skill-name-template.md # Output template (optional)
└── skill-name.prose # OpenProse orchestration (optional)
Skills are defined with YAML frontmatter:
yaml
---
name: my-skill
description: Use when [specific triggers]. Third person.
triggers:
- phrase that activates this skill
- another trigger phrase
template: my-skill-template.md # Optional output template
created: 2026-01-01
updated: 2026-01-01
---My Skill
Core principle: One sentence summary.
When to Use
- Trigger condition 1
- Trigger condition 2Quick Reference
| Task | Action |
|------|--------|Common Mistakes
| Mistake | Prevention |
|---------|------------|
`The
field enables automatic skill invocation when the user's message matches.See
docs/concepts/skill-architecture.md for the full architecture specification.Sub-Agents
Thoth delegates to specialized agents:
| Agent | Role |
|-------|------|
| Work Master | Professional life orchestrator |
| Life Master | Personal life orchestrator |
| Code Master | Technical projects (Sisyphus-quality code) |
| Coach | Reflection and thinking partner |
| Sentinel | Proactive monitoring |
| Diplomat | Communication drafting |
| Chronicler | Meeting and event processing |
Configuration
$3
~/.config/opencode/thoth-plugin.json:`json
{
"enabled": true,
"knowledge_base": "/path/to/your/thoth-kb"
}
`$3
in any workspace:`json
{
"knowledge_base": "./relative/path/to/kb"
}
`Development
$3
bash
git clone https://github.com/Skeptomenos/thoth-core.git
cd thoth-core
bun install
bun run build
`$3
1. Edit source in
2. Build:
3. Test locally: Add absolute path to OpenCode config
4. Publish: Thoth operates on these principles:
1. Chief of Staff, not servant — Warm but professional, challenges when appropriate
2. Context is king — Retrieves relevant knowledge before acting
3. Permission-aware — Critical actions require approval
4. Cross-domain synthesis — Can connect insights across hemispheres
5. Continuous learning — Persists learnings to the knowledge base
- npm: https://www.npmjs.com/package/thoth-plugin
- GitHub: https://github.com/Skeptomenos/thoth-core
MIT