mrap

Hex — AI skill for Claude Code

AI community

Persistent AI agent workspace for Claude Code.

How to install Hex

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mrap/hex and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hex does

Persistent AI agent workspace for Claude Code. Accumulates context, learns your patterns, self-improves. Install in 30 seconds.

Alternatives in AI

Context Engineering Agent Skills — Context engineering patterns for agent skills 13.9k ★
Pro Workflow — 1,400+ Battle-tested Claude Code workflows from power users 1.4k ★
Phantom — An AI co-worker with its own computer 1.3k ★

README

hex-foundation

A minimal, installable template for the hex system — a persistent AI workspace for Claude Code that accumulates context, learns your patterns, and improves itself over time.

**For:** engineers on Claude Code who are tired of their agent starting from zero every session.

Quick start

git clone https://github.com/mrap/hex-foundation /tmp/hex-setup && bash /tmp/hex-setup/install.sh && cd ~/hex && claude

Your agent walks you through setup on first run. Three questions, then you're working.

Prerequisites

Python 3.9+
git
Claude Code CLI (claude) — warning-only; install separately
Rust / cargo (rustup.rs) — required to build the hex binary from source; without it, install attempts a pre-built binary download

The installer sets up `~/.boi` (BOI worker fleet). BOI version pinned in [`VERSIONS`](./VERSIONS).

Install options

bash install.sh              # installs to ~/hex
bash install.sh ~/my-hex     # custom location

To use a fork of BOI, set `HEX_BOI_REPO` before running install.

What you get

After install, `~/hex/` contains:

~/hex/
├── CLAUDE.md         Operating model for Claude Code (system zone + your zone)
├── AGENTS.md         Operating model for other agents (Codex, Cursor, etc.)
├── todo.md           Your priorities and action items
├── me/               About you — me.md (stable), learnings.md (observed patterns)
├── projects/         Per-project context, decisions, meetings, drafts
├── people/           Profiles and relationship notes
├── evolution/        Self-improvement engine — observations, suggestions, changelog
├── landings/         Daily outcome targets
├── raw/              Transcripts, handoffs, unprocessed input
├── specs/            BOI spec drafts
├── .hex/             System files (scripts, skills, memory.db) — managed
└── .claude/commands/ Claude Cod