Skip to content

Commit c90ae80

Browse files
author
codejunkie99
committed
docs(readme): sync main README with v0.9.0 state
- Intro: add Antigravity to the harness list (10 supported, was 9). - Quickstart verbs: document `./install.sh manage` (interactive TUI shipped in v0.9.0 but missing from the verb cheatsheet). - Bare ./install.sh: describe the new multi-select wizard flow, the auto-detect pre-check, non-TTY exit code, and pre-v0.9 migration path via `./install.sh doctor` first. - Onboarding wizard: explain both entry points — bare wizard does a harness multi-select first, then preferences; named-adapter path goes straight to preferences. - Repo layout: add the new `harness_manager/` package (schema, install, state, doctor, remove, post_install, manage_tui, cli), note adapter.json manifests per adapter, add Formula/ line, flag `$CLAUDE_PROJECT_DIR` wiring for #18 next to claude-code adapter, note codex's .agents/skills symlink.
1 parent d23bb4d commit c90ae80

1 file changed

Lines changed: 38 additions & 10 deletions

File tree

README.md

Lines changed: 38 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Keep one portable memory-and-skills layer across coding-agent harnesses, so switching tools doesn't reset how your agent works.**
44

5-
A portable `.agent/` folder (memory + skills + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, Pi Coding Agent, Codex, or a DIY Python loop — and keeps its knowledge when you switch.
5+
A portable `.agent/` folder (memory + skills + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, Pi Coding Agent, Codex, Antigravity, or a DIY Python loop — and keeps its knowledge when you switch.
66

77
<p align="center">
88
<img src="docs/demo.gif" alt="agentic-stack demo" width="880"/>
@@ -78,16 +78,33 @@ verb-style subcommands (works with both `install.sh` and `install.ps1`):
7878
./install.sh add cursor # add a second adapter (Claude Code + Cursor in same repo)
7979
./install.sh status # one-screen view: which adapters, brain stats
8080
./install.sh doctor # read-only audit; green / yellow / red per adapter
81+
./install.sh manage # interactive TUI: header pane + menu loop for add/remove/audit
8182
./install.sh remove cursor # confirm prompt + delete; no quarantine, no undo
8283
```
8384

84-
Bare `./install.sh` (no arguments) prints the available adapters, or
85-
— on a project that already has an install.json — lists what's still
86-
installable.
85+
Bare `./install.sh` (no arguments) opens a **multi-select wizard** on
86+
a fresh project — check every harness you actually use, hit enter,
87+
each one gets installed. The wizard auto-detects harnesses already on
88+
disk and pre-checks them. On a project that already has an
89+
`install.json`, bare `./install.sh` lists what's still installable.
90+
In non-TTY shells (CI), it prints usage and exits with code 2.
91+
92+
Upgrading from pre-v0.9? Run `./install.sh doctor` first — it
93+
synthesizes `install.json` from on-disk adapter signals so the new
94+
backend can track them. Installing on top without migration would
95+
orphan the prior installs.
8796

8897
## Onboarding wizard
8998

90-
After the adapter is installed, a terminal wizard populates
99+
If you ran bare `./install.sh` (no adapter name), the wizard starts
100+
with a **multi-select harness step**: it lists all 10 adapters, pre-
101+
checks any it detects on disk, and installs each one you confirm with
102+
space + enter. After the install(s), the preferences flow runs.
103+
104+
If you ran `./install.sh <adapter>` directly, only the preferences
105+
flow runs.
106+
107+
Either way, the preferences step populates
91108
`.agent/memory/personal/PREFERENCES.md` — the **first file your AI reads
92109
at the start of every session** — and writes a feature-toggle file at
93110
`.agent/memory/.features.json`.
@@ -219,21 +236,32 @@ The index is stored at `.agent/memory/.index/` and gitignored.
219236
├── reject.py
220237
└── reopen.py
221238
222-
adapters/ # one small shim per harness
223-
├── claude-code/ (CLAUDE.md + settings.json hooks)
239+
adapters/ # one small shim per harness, each with adapter.json manifest
240+
├── claude-code/ (CLAUDE.md + settings.json hooks — $CLAUDE_PROJECT_DIR wired, closes #18)
224241
├── cursor/ (.cursor/rules/*.mdc)
225242
├── windsurf/ (.windsurfrules)
226243
├── opencode/ (AGENTS.md + opencode.json)
227244
├── openclaw/ (AGENTS.md + system-prompt include; auto-registers per-project agent)
228245
├── hermes/ (AGENTS.md)
229246
├── pi/ (AGENTS.md + .pi/skills symlink)
230-
├── codex/ (AGENTS.md)
247+
├── codex/ (AGENTS.md + .agents/skills symlink)
231248
├── standalone-python/ (DIY conductor entrypoint)
232249
└── antigravity/ (ANTIGRAVITY.md)
233250
251+
harness_manager/ # v0.9.0 manifest-driven Python backend
252+
├── schema.py # adapter.json validator (path-safe on POSIX + Windows)
253+
├── install.py # applies file entries per merge_policy
254+
├── state.py # install.json read/write with fcntl/msvcrt locking
255+
├── doctor.py # read-only audit + pre-v0.9 migration synthesis
256+
├── remove.py # safe uninstall with shared-file detection + ownership handoff
257+
├── post_install.py # named built-ins (openclaw_register_workspace)
258+
├── manage_tui.py # interactive menu loop for add/remove/audit
259+
└── cli.py # argparse dispatcher for install.sh / install.ps1
260+
234261
docs/ # architecture, getting-started, per-harness
235-
install.sh # mac / linux / git-bash installer
236-
install.ps1 # Windows PowerShell installer
262+
install.sh # mac / linux / git-bash installer (thin Python dispatcher)
263+
install.ps1 # Windows PowerShell installer (thin Python dispatcher)
264+
Formula/agentic-stack.rb # Homebrew formula
237265
CHANGELOG.md # per-version release notes (v0.1.0 onward)
238266
onboard.py # onboarding wizard entry point
239267
onboard_features.py # .features.json read/write

0 commit comments

Comments
 (0)