@pi-unipi/unipi 0.1.1

package/README.md

@@ -0,0 +1,143 @@
+# Unipi
+
+All-in-one extension suite for the [Pi coding agent](https://github.com/badlogic/pi-mono).
+
+## Install
+
+**All-in-one:**
+```bash
+pi install npm:unipi
+```
+
+**Individual packages:**
+```bash
+pi install npm:@pi-unipi/core
+pi install npm:@pi-unipi/workflow
+pi install npm:@pi-unipi/ralph
+pi install npm:@pi-unipi/memory
+pi install npm:@pi-unipi/info-screen
+pi install npm:@pi-unipi/subagents
+pi install npm:@pi-unipi/btw
+```
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| `@pi-unipi/core` | Shared utilities, event types, constants |
+| `@pi-unipi/workflow` | 13 structured development workflow commands |
+| `@pi-unipi/ralph` | Long-running iterative development loops |
+| `@pi-unipi/memory` | Persistent cross-session memory with vector search |
+| `@pi-unipi/info-screen` | Dashboard and module registry overlay |
+| `@pi-unipi/subagents` | Parallel sub-agent execution with file locking |
+| `@pi-unipi/btw` | Parallel side conversations with `/btw` |
+
+## Commands
+
+### Workflow (`/unipi:*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:brainstorm` | Collaborative discovery |
+| `/unipi:plan` | Strategic planning |
+| `/unipi:work` | Execute plan in worktree |
+| `/unipi:review-work` | Review what was built |
+| `/unipi:consolidate` | Merge findings, update docs |
+| `/unipi:worktree-create` | Create git worktree |
+| `/unipi:worktree-list` | List all worktrees |
+| `/unipi:worktree-merge` | Merge worktree back |
+| `/unipi:consultant` | Expert panel review |
+| `/unipi:quick-work` | Fast single-task execution |
+| `/unipi:gather-context` | Research codebase |
+| `/unipi:document` | Generate documentation |
+| `/unipi:scan-issues` | Find bugs, anti-patterns |
+
+### Ralph (`/unipi:ralph`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:ralph start <name>` | Start a loop |
+| `/unipi:ralph stop` | Pause current loop |
+| `/unipi:ralph resume <name>` | Resume a paused loop |
+| `/unipi:ralph status` | Show all loops |
+| `/unipi:ralph cancel <name>` | Delete loop state |
+| `/unipi:ralph archive <name>` | Archive completed loop |
+| `/unipi:ralph clean` | Clean completed loops |
+| `/unipi:ralph nuke` | Delete all ralph data |
+
+### Memory (`/unipi:*-memory-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:memory-process <text>` | Store extracted memories |
+| `/unipi:memory-search <term>` | Search project memories |
+| `/unipi:memory-consolidate` | Consolidate session into memory |
+| `/unipi:memory-forget <title>` | Delete a memory |
+| `/unipi:global-memory-search <term>` | Search global memories |
+| `/unipi:global-memory-list` | List all global memories |
+
+### BTW (`/btw*`)
+
+| Command | Description |
+|---------|-------------|
+| `/btw [--save] <question>` | Side conversation (contextual) |
+| `/btw:tangent [--save] <q>` | Contextless tangent thread |
+| `/btw:new [question]` | Fresh thread with main-session context |
+| `/btw:clear` | Dismiss and clear thread |
+| `/btw:inject [instructions]` | Send full thread to main agent |
+| `/btw:summarize [instr]` | Summarize and inject into main agent |
+
+### Info Screen (`/unipi:info*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:info` | Show info dashboard |
+| `/unipi:info-settings` | Configure info display |
+
+### Tools
+
+| Tool | Package | Description |
+|------|---------|-------------|
+| `ralph_start` | ralph | Start a ralph loop |
+| `ralph_done` | ralph | Signal iteration complete |
+| `spawn_helper` | subagents | Spawn parallel sub-agent |
+| `get_helper_result` | subagents | Retrieve background agent result |
+| `memory_store` | memory | Store/update memory |
+| `memory_search` | memory | Search project memories |
+| `memory_delete` | memory | Delete memory by ID |
+| `memory_list` | memory | List project memories |
+| `global_memory_search` | memory | Search global memories |
+| `global_memory_list` | memory | List global memories |
+
+## How It Works
+
+**Core** provides shared infrastructure — event types, constants, utilities — so modules discover each other without tight coupling.
+
+**Workflow** provides 13 commands guiding work from idea to completion via brainstorm → plan → work → review → consolidate.
+
+**Ralph** enables long-running iterative tasks. Start a loop, the agent works through iterations, reflects periodically, and completes when done.
+
+**Memory** provides persistent cross-session memory with SQLite + vector search. Project-scoped and global memories with hybrid search.
+
+**Info Screen** is a dashboard overlay showing module status, registered tools, and custom groups from all modules.
+
+**BTW** adds a parallel side-conversation channel. Ask questions while the main agent keeps working, then inject or summarize the thread back.
+
+**Subagents** enables parallel execution with file locking, activity tracking, and custom agent types.
+
+## Module Discovery
+
+Modules announce presence via `pi.events`. When `@pi-unipi/workflow` detects `@pi-unipi/ralph`, it enables loop integration. Each module works standalone.
+
+## Development
+
+```bash
+git clone https://github.com/Neuron-Mr-White/unipi.git
+cd unipi
+npm install
+npm run typecheck
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@pi-unipi/unipi",
+  "version": "0.1.1",
+  "description": "All-in-one extension suite for Pi coding agent",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git"
+  },
+  "homepage": "https://github.com/Neuron-Mr-White/unipi#readme",
+  "bugs": {
+    "url": "https://github.com/Neuron-Mr-White/unipi/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "unipi"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "typecheck": "npx tsc --noEmit --skipLibCheck",
+    "publish:all": "npm publish --workspaces --access public"
+  },
+  "files": [
+    "packages/*/index.ts",
+    "packages/*/extensions/**/*.ts",
+    "packages/*/skills/**/*",
+    "packages/*/README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "node_modules/@pi-unipi/workflow/index.ts",
+      "node_modules/@pi-unipi/ralph/index.ts",
+      "node_modules/@pi-unipi/memory/index.ts",
+      "node_modules/@pi-unipi/info-screen/index.ts",
+      "node_modules/@pi-unipi/subagents/src/index.ts",
+      "node_modules/@pi-unipi/btw/extensions/btw.ts"
+    ],
+    "skills": [
+      "node_modules/@pi-unipi/workflow/skills",
+      "node_modules/@pi-unipi/ralph/SKILL.md",
+      "node_modules/@pi-unipi/memory/skills",
+      "node_modules/@pi-unipi/btw/skills"
+    ]
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "@sinclair/typebox": "*"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "*",
+    "@pi-unipi/workflow": "*",
+    "@pi-unipi/ralph": "*",
+    "@pi-unipi/memory": "*",
+    "@pi-unipi/info-screen": "*",
+    "@pi-unipi/subagents": "*",
+    "@pi-unipi/btw": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.0"
+  }
+}

package/packages/btw/README.md

@@ -0,0 +1,95 @@
+# @pi-unipi/btw
+
+A [pi](https://github.com/badlogic/pi-mono) extension for parallel side conversations with `/btw` — part of the [Unipi](https://github.com/Neuron-Mr-White/unipi) suite.
+
+`/btw` opens a real pi sub-session with coding-tool access, running immediately even while the main agent is still busy.
+
+Based on [pi-btw](https://github.com/Neuron-Mr-White/pi-btw) by Dan Bachelder.
+
+## Install
+
+As part of the full Unipi suite:
+
+```bash
+pi install npm:unipi
+```
+
+Standalone:
+
+```bash
+pi install npm:@pi-unipi/btw
+```
+
+## Usage
+
+```text
+/btw what file defines this route?
+/btw how would you refactor this parser?
+/btw --save summarize the last error in one sentence
+/btw:new let's start a fresh thread about auth
+/btw:tangent brainstorm from first principles without using the current chat context
+/btw:inject implement the plan we just discussed
+/btw:summarize turn that side thread into a short handoff
+/btw:clear
+```
+
+## Commands
+
+### /btw [--save] <question>
+
+- runs right away, works while pi is busy
+- creates or reuses a real BTW sub-session
+- continues the current BTW thread
+- opens a focused BTW modal shell
+- streams into the BTW modal transcript/status surface
+- persists the BTW exchange as hidden thread state
+- with `--save`, also saves that single exchange as a visible session note
+
+### /btw:new [question]
+
+- clears the current BTW thread
+- starts a fresh thread that still inherits the current main-session context
+- optionally asks the first question in the new thread immediately
+
+### /btw:tangent [--save] <question>
+
+- starts or continues a contextless tangent thread
+- does not inherit the current main-session conversation
+- with `--save`, also saves that single exchange as a visible session note
+
+### /btw:clear
+
+- dismisses the BTW modal/widget
+- clears the current BTW thread
+
+### /btw:inject [instructions]
+
+- sends the full BTW thread back to the main agent as a user message
+- if pi is busy, queues it as a follow-up
+- clears the BTW thread after sending
+
+### /btw:summarize [instructions]
+
+- summarizes the BTW thread with the current model
+- injects the summary into the main agent
+- clears the BTW thread after sending
+
+## Overlay controls
+
+- `Alt+/` toggles focus between BTW and the main editor without closing the overlay
+- `Ctrl+Alt+W` is a fallback focus toggle for terminals that do not deliver `Alt+/` as a usable shortcut
+- `Esc` still dismisses BTW immediately while the overlay is focused
+- `PgUp`/`PgDn` scrolls the transcript
+- BTW opens top-centered so the main session remains visible underneath
+
+## Why
+
+Sometimes you want to:
+
+- ask a clarifying question while the main agent keeps working
+- think through next steps without derailing the current turn
+- explore an idea, then inject it back once it's ready
+
+## License
+
+MIT