⠀⠀⠀⠀⣠⣤⣶⣶⣶⣤⣄⡀⠀
⠀⠀⣴⣾⣿⣿⣿⣿⣿⣧⡀⠈⠢
⠀⣼⣿⣿⣿⣿⣿⣿⣿⡿⠁⠀⠀
⢰⡿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀
⠘⣽⡿⠿⠿⣿⣿⣿⣿⣿⣦⣤⡀
⠀⣟⠀⠀⠀⣸⣿⡏⠀⠀⠀⢹⠗  nothingness
⠀⣿⣷⣶⣾⡿⠁⠙⣄⣀⣀⣠⡀
⠀⠙⠙⢿⡿⣷⣶⣤⣿⣿⡿⠿⠃
⠀⠀⠀⠺⡏⡏⡏⡏⡏⠉⠁⠀⠀
⠀⠀⠀⠀⠀⠀⠁⠁⠀⠀⠀⠀⠀

nothing 🧠

The ultimate local-first agentic development environment. nothing transforms the Pi Coding Agent into a professional, reproducible workflow engine with built-in privacy guards, specialized personas, and advanced context optimization.

nothing wires together Pi "hats", local workflow skills, privacy extensions, local context compression, and optional behavior modifiers into a single, cohesive setup that works identically on Linux and macOS.

---

✨ Features

• 🛡️ Privacy First: Always-on credential and secret guard via @raquezha/noleaks.
• 🎩 Persona "Hats": Instant switching between Triage, PM, Dev, and Meta engineering modes.
• 🗜️ Context Optimization: Integrated local Headroom compression via @raquezha/noheadroom.
• 🔄 Workflow Platform: A generic Workflow Contract focusing on 3 Real Modes (Chat, Research, RPIV), using a centralized .workflow/active.json to manage state locally without over-engineering.
• 🧾 Retrospective Memory: Versioned notrace.json session evidence plus HTML reports via @raquezha/notrace, with optional extension telemetry.
• 🐎 Simplicity Pressure: Optional Ponytail modifier for YAGNI-first, stdlib-first, minimal-diff behavior.
• 🔄 RPIV Workflow: A formal Frame → Plan → Implement → Verify → Sync cycle for reliable agentic output.
• 🚀 One-Command Bootstrap: reproducible environment setup across home and work machines.

📦 What's Inside

Category	Component	Purpose
Privacy	@raquezha/noleaks	credential & secret protection
Optimization	headroom/, @raquezha/noheadroom	local context compression
Workflow	@raquezha/norpiv, noresearch, docs/workflow.md	RPIV execution workflow, local Research workflow, and platform workflow contract
Design	@raquezha/nodesign	deterministic design preflight & Android UI stack detector
Search	@raquezha/nosearch	Brave & Firecrawl subagent
UI/UX	@raquezha/notrace, nofooter	retrospective run records, HTML reports, and powerline footer
Providers	@raquezha/antigravity	Google Antigravity model support
Behavior	Ponytail	optional lazy senior-dev ruleset and review commands

🚀 Getting Started

1. Install Full Setup

Fresh machine / personal setup:

git clone https://github.com/raquezha/nothing.git
cd nothing
./bootstrap.sh --headroom

⚠️ Warning: ./bootstrap.sh archives/resets global Pi discovery directories to ensure a clean, reproducible starting state. Use --no-reset-pi if you want to keep existing global resources.

2. Reload Shell

source ./dotfiles/shell_integration.sh

🎩 Persona Hats & Modifiers

Base hats load repo-local skills and personas:

pi --rpiv        # standard RPIV workflow (Frame -> Implement -> Verify)
pi --research    # intentional research workflow (or: pi --research "topic")
pi --nochestra   # optional Nochestra control-plane entrypoint scaffold
pi --nochestra-worker --handoff /tmp/handoff.json  # bounded worker entrypoint
pi --pm          # research, planning, and sync persona
pi --dev         # implementation and verification focus
pi --android     # Android development expert; loads local Android CLI skill cache only
pi --meta        # skill engineering and nothing maintenance
pi --nothing     # ultimate "clean" mode: zero built-in tools/context

Additive modifiers for power users:

pi --headroom    # enable local context compression
pi --caveman     # terse, token-efficient communication
pi --rtk         # local terminal output optimization
pi --notrace     # write session retrospective artifacts
pi --ponytail    # load Ponytail's minimal-diff rules and commands
pi --tkmx        # THE COMBO: --antigravity + --headroom + --caveman + --rtk + --notrace + --ponytail

🔄 Multi-machine Git sync

After bootstrap, use:

rqz-sync --dry-run  # inspect every repo under ~/RQZ
rqz-sync --safe     # only pull/push clean repos
rqz-sync            # commit dirty tracked branches, then sync

See rqz-sync for its upstream-branch policy and stop conditions.

🧩 Standalone Usage

Don't want the full setup? You can still use the skills and packages independently.

Install published skills

npx -y skills add raquezha/nothing --full-depth -g -a pi -s '*' -y

Install Pi packages

pi install npm:@raquezha/noheadroom
pi install npm:@raquezha/norpiv

Ponytail behavior modifier

pi --ponytail lazy-clones the upstream Ponytail repo into ~/.local/share/nothing/repos/ponytail on first use, then loads its Pi extension and skills locally.

Useful commands once loaded:

/ponytail status
/ponytail full
/ponytail ultra
/ponytail-review
/ponytail-audit

---

🛠 Maintenance

• Build packages: npm run build --workspaces
• Verify repo: npm test
• Refresh managed caches: pi update

Android CLI skills cache

pi --android never installs, updates, or checks the network. It only loads the local cache at $NOTHING_CACHE_DIR/android-skills (default: ~/.local/share/nothing/android-skills). If the cache is missing or locally stamped stale, it warns and continues safely.

Run pi update when you explicitly want network work. It updates Pi plus nothing-managed caches: Android CLI skills, Caveman, Ponytail, RTK, and the Headroom image. The Android refresh script remains as an internal helper: it runs android update, installs skills with android skills add --all --project=<temp project>, verifies skills/android-cli/SKILL.md, and atomically swaps the cache.

If the Android CLI is missing, the script prints the Linux/macOS install command. It only runs the installer when you pass --install-cli.

🤝 Attribution

• Powered by Pi Coding Agent.
• Context compression by Headroom.
• Terse mode inspired by Caveman.

---

nothing — Built for local-first agentic autonomy.