agentic-stack

Follow me on @AV1DLIVE for updates/collabs on projects.

Coded using Minimax-M2.7 in the Claude Code Harness. PR Review by Macroscope and Codex

One brain, many harnesses. A portable .agent/ folder (memory + skills

• protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, Pi Coding Agent, or a DIY Python loop, and keeps its knowledge when you switch.

Based on the article: "The Agentic Stack" · by @AV1DLIVE

Quickstart

macOS / Linux

# tap + install (one-time — both lines required)
brew tap codejunkie99/agentic-stack 
brew install agentic-stack

# drop the brain into any project — the onboarding wizard runs automatically
cd your-project
agentic-stack claude-code
# or: cursor | windsurf | opencode | openclaw | hermes | pi | standalone-python

Windows (PowerShell)

# clone + run the native installer
git clone 
cd agentic-stack
.\install.ps1 claude-code C:\path\to\your-project

Already installed?

brew update && brew upgrade agentic-stack

Clone instead?

git clone 
cd agentic-stack && ./install.sh claude-code         # mac / linux / git-bash
# or on Windows PowerShell: .\install.ps1 claude-code
# adapters: claude-code | cursor | windsurf | opencode | openclaw | hermes | pi | standalone-python

Onboarding wizard

After the adapter is installed, a terminal wizard populates .agent/memory/personal/PREFERENCES.md — the first file your AI reads at the start of every session — and writes a feature-toggle file at .agent/memory/.features.json.

Six preference questions (each skippable with Enter):

| Question | Default | |---|---| | What should I call you? | (skip) | | Primary language(s)? | unspecified | | Explanation style? | concise | | Test strategy? | test-after | | Commit message style? | conventional commits | | Code review depth? | critical issues only |

Plus one Optional features step (opt-in, off by default):

| Feature | Default | |---|---| | Enable FTS memory search [BETA] | no |

Flags:

agentic-stack claude-code --yes          # accept all defaults, beta off (CI/scripted)
agentic-stack claude-code --reconfigure  # re-run the wizard on an existing project

Edit .agent/memory/personal/PREFERENCES.md any time to refine your conventions, or .agent/memory/.features.json to flip feature toggles.

Review protocol (host-agent CLI)

The nightly auto_dream.py cycle only stages candidate lessons. It does not mark anything accepted or modify semantic memory. Your host agent does the review in-session:

# list pending candidates, sorted by priority
python3 .agent/tools/list_candidates.py

# accept with rationale (required)
python3 .agent/tools/graduate.py  --rationale "evidence holds, matches PREFERENCES"

# reject with reason (required); preserves decision history
python3 .agent/tools/reject.py  --reason "too specific to gen