hide: - navigation - toc
Apothem¶
One shared profile. Eleven AI tools. No reinvention.
Apothem ships your behavioral rules, slash-command pipeline, persistent agents, hooks, and skills as a single portable profile that materializes into each AI coding tool's native config directory via per-harness adapters -- so every tool behaves the same way, on every machine.
Get started in 60 seconds See the harnesses
Install¶
pipx install apothem # recommended
uvx apothem # ephemeral
brew install Gad360/apothem/apothem
irm https://apothem.ahmedgad.com/install.ps1 | iex
winget install Gad360.Apothem
scoop bucket add apothem https://github.com/Gad360/apothem && scoop install apothem/apothem
yay -S apothem
After installing, wire and verify:
apothem install # materializes profile into all detected harnesses
apothem verify # confirms the adapter stack is live
Why Apothem¶
Consistent behavior across every AI tool. Stop re-writing the same rules for Claude, Cursor, Copilot, and Gemini. Apothem maintains one shared profile and materializes it into each tool on install.
Context survives session boundaries. The five-stage plan-suite pipeline (/plan-spec + /plan-generate + /plan-execute) captures intent in structured artifacts that survive compaction, restart, and machine changes.
Quality gates are enforcement, not habit. Fifteen-bar pre-emission conformity gate and real-time hooks block non-conforming output before it reaches disk. The eleven-command audit fortress gives full production-readiness coverage on demand.
One install, eleven platforms. Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Windsurf, OpenCode, Antigravity, Open-Claw, Hermes, and Qwen Code -- all governed by the same profile.
Supply-chain ready from day one. SBOM generation, dependency pinning, SLSA-3 provenance, Sigstore signing, REUSE compliance, and OpenSSF Scorecard -- baked into the CI pipeline, not bolted on later.
Features¶
| Feature | What it does |
|---|---|
| Behavioral rules | Always-on or path-filtered instructions loaded on every interaction |
| Plan suite pipeline | Five-stage /plan-* commands for spec, generation, review, execution, and status |
| Audit fortress | Eleven review/audit commands: code, security, perf, UX, a11y, docs, supply-chain, threat model |
| Hooks | Real-time PreToolUse/PostToolUse/SessionStart enforcement of conformity mandates |
| Persistent agents | Research, audit, quality, and memory agents scoped to a single purpose |
| Skills | Reusable, detectable techniques invoked via slash-command |
| Harness adapters | Per-platform adapter that materializes the shared profile into native config |
| Conformity gate | Fifteen-bar pre-emission gate with severity ladder |
Harness Adapters¶
Apothem ships adapters for eleven AI coding platforms. Install once; all detected harnesses are wired.
| Adapter | Platform | Status |
|---|---|---|
| Claude Code | Anthropic | GA |
| Cursor | Cursor | GA |
| Gemini CLI | GA | |
| GitHub Copilot | Microsoft | GA |
| Windsurf | Codeium | GA |
| Codex | OpenAI | Beta |
| OpenCode | OpenCode | Beta |
| Qwen Code | Alibaba | Beta |
| Antigravity | Antigravity | Preview |
| Open-Claw | Open-Claw | Preview |
| Hermes | Nous Research | Preview |
Documentation¶
| Section | Description |
|---|---|
| Getting Started | Installation, quick-start, troubleshooting |
| CLI Reference | All subcommands, flags, and exit codes |
| Architecture | System design, harness adapter protocol, shared profile schema |
| Concepts | Core ideas: AI-platform agnosticism, review fortress, seriousness tiers |
| Pipeline Commands | /plan-* and review/audit slash-command reference |
| Conformity Gate | The fifteen-bar pre-emission gate |
| Plan Suite | Plan discipline, _inputs/_outputs siblings, DoR/DoD |
| Brand | Logo, palette, rebuild recipe |
| ADRs | Architecture Decision Records (D-LAUNCH-N decisions) |
Apothem is open-source software released under the MIT License. Maintained by Ahmed G. Gad.