Status: v7.0.0 stable — shipped 2026-05-19

AIPS v7.0 is the current, supported release. The 11 /aips:* slash commands, hybrid global-first layout, 4 bundled plugins, and 3-line statusline are all in place and tested on Linux, macOS, and Git Bash / WSL. If you're already running v6.0, migration is one command (/aips:upgrade --to v7.0) and the strict mode result is byte-identical to a fresh v7.0 install.

Table of contents

• Why this exists
• Quick start
• What lands where
• Lifecycle
• Statusline
• Slash commands
• Migration
• Supported AI tools
• Comparison
• Documentation
• FAQ
• Roadmap
• Star history
• Support
• License

Why this exists

You've been here before:

• Cloned a fresh repo, then spent an hour re-wiring CLAUDE.md, .cursorrules, AGENTS.md, the same 4 hooks, the same 9 backup scripts.
• Lost a 2-hour session to a /clear because nobody wrote a handoff.
• Re-installed RTK and caveman on a new laptop and forgot which order matters.
• Watched the AI burn 25k tokens reading a setup doc before doing actual work.
• Renamed a project directory and watched session history evaporate.

AIPS v7.0 fixes all of that with a single principle: state that should be global, lives global. State that should be local, lives local. Nothing duplicated.

Quick start

Once per machine — runs for every project you'll ever open:

curl -fsSL https://raw.githubusercontent.com/kernalix7/AIPS/main/install.sh | bash

What install.sh does:

1. Registers the AIPS marketplace in ~/.claude/
2. Installs / updates 4 bundled plugins:
   • codex-plugin-cc — /codex:* commands (Claude ↔ Codex relay)
   • caveman — ultra-terse output style + /caveman* commands
   • agentmemory + systemd unit — file-backed memory + auto-backup
   • RTK (Rust Token Killer) — 60–90% token savings CLI proxy
3. Drops hooks / agents / commands / skills / output-styles / statusline into ~/.claude/
4. Globalizes toolkit scripts (~/.local/bin/aips-*) and the AIPS gitignore block (~/.config/git/ignore)

Per project:

cd my-project
claude
> /aips:init

/aips:init auto-detects 4 cases:

Done. Every artifact is gitignored — your git history stays clean. Verify any time with /aips:health.

What lands where

v7.0 keeps a clean split: smart globals once per machine, minimum-viable per-project state per repo. Nothing is duplicated.

Global — ~/.claude/ + ~/.local/bin/ + ~/.config/git/ignore

Installed once by install.sh. Every project inherits.

Per-project — .priv-storage/ (/aips:init)

your-project/
|-- CLAUDE.md              -> .priv-storage/CLAUDE.md  (symlink)
|-- AGENTS.md              -> .priv-storage/CLAUDE.md  (symlink, Codex / Copilot)
|-- .cursorrules           -> .priv-storage/CLAUDE.md  (symlink, Cursor)
|-- WORK_STATUS.md         -> .priv-storage/WORK_STATUS.md
|
|-- .priv-storage/         [gitignored] per-project AI state
|   |-- CLAUDE.md                   # Sections 1-7 + 11 only, ~150 lines
|   |-- CLAUDE.local.md             # per-developer overrides
|   |-- WORK_STATUS.md              # team-shared task state
|   |-- sessions/                   # fast-write buffer; mirrored globally
|   |-- agents/                     # tech-lead.md + per-team agents
|   `-- .mcp.json                   # project-specific MCP server registry
|
`-- tmp-igbkp/             [gitignored] encrypted backup outputs only
    `-- (archives produced by aips-archive, aips-restore, aips-purge-history)

Only WORK_STATUS.md, GitHub standard files, the docs/ Korean mirrors, and .github/ get committed. Everything in .priv-storage/ and tmp-igbkp/ is gitignored on purpose. CLAUDE.md keeps Sections 1–7 + 11 (~150 lines) — Sections 8/9/10/12/13 moved into the global plugin / skill / hook layer.

Why this split

Lifecycle

[1. Global install] (once per machine)
  curl ... | bash
  - Register AIPS marketplace → ~/.claude/
  - Install/update 4 bundled plugins
  - Drop hooks/agents/commands/skills/output-styles/statusline
  - Globalize toolkit (~/.local/bin/aips-*) + gitignore block
  - Install RTK binary, agentmemory systemd unit
        |
        v
[2. Project init] (once per project, ~30 sec)
  cd project && claude → /aips:init
  - Auto-branch A/B/C/D
  - Create .priv-storage/, drop 3 symlinks
  - CLAUDE.md Sections 1-7 + 11 (~150 lines)
  - Register project with global sessions mirror + memory store
        |
        v
[3. Normal session]
  - SessionStart hook auto-injects prior handoff + current.md tail
  - AI reads only CLAUDE.md (~150 lines) — no 7,600-line .md
  - PreToolUse blocks dangerous commands + oversized reads
  - PostToolUse appends current.md + dual-writes to agentmemory
  - Stop hook writes handoff-{date}.md
  - PreCompact hook writes recovery.md (best-effort)
  - 3-line statusline updates live: project / windows / savings
        |
        v
[4. Crash / rate-limit / /clear / rename]
  - Next session, SessionStart auto-loads handoff + recovery
  - AI resumes prior state without asking "where were we?"
  - Renamed project? `/aips:rebind <old-path>` rewires globals
        |
        v
[5. Updates] (trigger: /aips:update)
  - marketplace pull → update 4 bundled plugins
  - Global hooks/commands auto-sync
  - Projects untouched (re-init via /aips:init if needed)

Statusline

3-line multi-line. Three glances tell you everything: what you're working on, how much budget you have left, and how much you've saved.

project [main*3] wip:2 | opus-4.7 | ctx:8%(15.5k/200k) | cache:71%
5h:8% ↻2h11m ∅1h23m | wk:12% ↻4d18h ∅2d4h
🦴cv:75%/full | 🧠am:40%/127 | 💰rtk:34% | 🤖cdx:55%/3runs | 💯Σ:95%

↻ = time until reset · ∅ = projected empty ETA at current burn rate · Σ = cumulative savings (Σ = 1 − Π(1 − SAVED_i / 100)).

Slash commands

AIPS native — 11 commands

Bundled plugin commands

Legacy custom /codex-brief, /codex-review, /codex-fix, /codex-relay-status from v5.x were retired in v6.0. Use /codex:* from the official codex-plugin-cc instead.

Migration

From v5.x — /aips:init handles it

cd existing-v5-project
claude
> /aips:init
# → Detects root AI_PROJECT_SETUP.md (v5.x)
# → "v5.x install detected. Migrate to v7.0? [y/N]"
# → On y:
#   1. Full backup to .priv-storage/v5-backup/
#   2. Reduce 7,600-line AI_PROJECT_SETUP.md → 30-line DEPRECATED redirect
#   3. Remove custom /codex-* (4 commands) — replaced by codex-plugin-cc
#   4. Slim CLAUDE.md to Sections 1-7 + 11 only (~150 lines)
#   5. Register with global sessions mirror + memory store
#   6. Write v7.0 marker

Or trigger it explicitly: /aips:migrate-from-md.

From v6.0 — /aips:upgrade --to v7.0

cd existing-v6-project
claude
> /aips:upgrade --to v7.0
# → Strict mode (default): result is identical to a fresh v7.0 install.
#   per-project tmp-igbkp/*.sh and sessions/*.md are purged after their
#   global counterparts are verified. Full backup at
#   tmp-igbkp/upgrade-v7-backup-{ts}/ is always taken first.
# → Pass --keep-local-fallback to retain both as fallback (lenient).

What v7.0 changed vs v6.0

Supported AI tools

AIPS is built for Claude Code first. Other tools get policy-only support via CLAUDE.md / AGENTS.md / .cursorrules. Full plugin parity for them is on the roadmap.

Tier 1 — Primary / Full

Tier 2 — Partial (policy-only)

Policy-only = rules enforced through prompt content. No kernel-level blocking, no hooks, no slash commands, no statusline — but the rule file is read by the AI and followed.

Tier 3 — Full support TBD

Full plugin-like parity (hooks, slash commands, statusline, bundled-plugin stack) for Codex / Cursor / Copilot is roadmap. Track progress in Roadmap or open an issue to upvote.

Comparison

Documentation

FAQ

Roadmap

• v7.0.0 (stable, 2026-05-19) — Hybrid global-first: globalized toolkit / sessions / memory / gitignore, 3 new /aips:* commands (upgrade --to v7.0, rebind, scope), strict-by-default non-breaking migration from v6.0
• v7.1 — agentmemory deeper integration: cross-project workflow recommendations, shared lesson surfaces visible in /am:recall
• v7.2 — /aips:rebind UX: auto-detect moved projects via path-hash heuristics; one-command recovery without specifying <old-path>
• v7.3 — Tier 2 → Tier 1 promotion experiments: prototype hook / statusline support for Codex CLI via wrapper shim
• v8.0 (candidate) — Team-shared globals via opt-in cloud sync, or full plugin-marketplace publishing for third-party AIPS extensions

See CHANGELOG.md for shipped versions.

Star history

Support

If AIPS saved you setup time:

Ko-fi handles international cards and PayPal; fairy.hada.io is a Korean tipping platform. Bug reports, PRs, and stars on the repo are equally appreciated and free.

License

MIT — Kim DaeHyun (kernalix7@kodenet.io)