sisyphi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Silas Rhyneer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,175 @@
+# sisyphi
+
+A tmux-integrated orchestration daemon for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) multi-agent workflows.
+
+A background daemon manages sessions where an **orchestrator** Claude instance breaks tasks into subtasks, spawns **agent** Claude instances in tmux panes, and coordinates their lifecycle through cycles. Agents work in parallel, submit reports, and the orchestrator respawns each cycle with fresh context to review progress and plan next steps.
+
+## How It Works
+
+```
+You ──► sisyphus start "build auth system"
+              │
+              ▼
+        ┌─────────────┐
+        │ Orchestrator │  ◄── Reads state, plans work, spawns agents
+        └──────┬──────┘
+               │ sisyphus spawn (×N)
+               ▼
+     ┌─────┐ ┌─────┐ ┌─────┐
+     │ A-1 │ │ A-2 │ │ A-3 │  ◄── Parallel Claude agents in tmux panes
+     └──┬──┘ └──┬──┘ └──┬──┘
+        │       │       │
+        ▼       ▼       ▼
+   sisyphus submit (each agent reports back)
+              │
+              ▼
+        ┌─────────────┐
+        │ Orchestrator │  ◄── Respawned with updated state (next cycle)
+        └─────────────┘
+```
+
+1. **You** run `sisyphus start` with a high-level task
+2. **Orchestrator** decomposes it, adds tasks, spawns agents, yields
+3. **Agents** work in parallel tmux panes, send progress reports, submit when done
+4. **Daemon** detects completion, respawns orchestrator with updated state
+5. **Orchestrator** reviews reports, spawns more agents or completes the session
+
+The orchestrator is stateless — it's killed after yielding and respawned fresh each cycle with the full session state. This means it never runs out of context, no matter how many cycles a session takes.
+
+## Requirements
+
+- **Node.js** >= 22
+- **tmux** (you must be inside a tmux session)
+- **Claude Code** CLI (`claude`) installed and authenticated
+
+## Install
+
+```bash
+npm install -g sisyphi
+```
+
+This gives you two commands:
+- `sisyphus` — the CLI for interacting with sessions
+- `sisyphusd` — the background daemon
+
+## Quick Start
+
+### 1. Start the daemon
+
+```bash
+sisyphusd
+```
+
+Or run it in the background. On macOS you can use launchd — create `~/Library/LaunchAgents/com.sisyphus.daemon.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.sisyphus.daemon</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>sisyphusd</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>~/.sisyphus/daemon.log</string>
+  <key>StandardErrorPath</key>
+  <string>~/.sisyphus/daemon.log</string>
+</dict>
+</plist>
+```
+
+Then load it:
+
+```bash
+launchctl load ~/Library/LaunchAgents/com.sisyphus.daemon.plist
+```
+
+### 2. Start a session (inside tmux)
+
+```bash
+sisyphus start "Refactor the authentication module to use JWT tokens"
+```
+
+The orchestrator spawns in a yellow tmux pane and begins planning.
+
+### 3. Watch it work
+
+```bash
+sisyphus status     # Check session state, tasks, agents
+sisyphus tasks list # View task breakdown
+```
+
+Agent panes appear as the orchestrator spawns them, color-coded by agent:
+
+| Role | Color |
+|------|-------|
+| Orchestrator | Yellow |
+| Agents | Blue, Green, Magenta, Cyan, Red, White (rotating) |
+
+### 4. Resume or complete
+
+```bash
+sisyphus resume <session-id>                    # Resume a paused session
+sisyphus resume <session-id> "focus on tests"   # Resume with new instructions
+sisyphus list                                   # List all sessions
+```
+
+## CLI Reference
+
+```bash
+# Session lifecycle
+sisyphus start "task description"           # Create session, launch orchestrator
+sisyphus status                             # Current session state
+sisyphus list                               # List all sessions
+sisyphus resume <id> [message]              # Resume paused session
+sisyphus kill <id>                          # Kill a session
+
+# These are used by the orchestrator/agents (not typically run manually):
+sisyphus spawn --agent-type <t> --name <n> --instruction "..."
+sisyphus yield                              # Orchestrator yields control
+sisyphus complete --report "summary"        # Mark session done
+sisyphus submit --report "findings"         # Agent submits final report
+sisyphus report --message "progress"        # Agent sends progress update
+
+# Task management
+sisyphus tasks list
+sisyphus tasks add "description"
+sisyphus tasks add "idea" --status draft
+echo "long description" | sisyphus tasks add    # stdin piping
+sisyphus tasks update <taskId> --status done
+sisyphus tasks update <taskId> --description "refined"
+```
+
+## Architecture
+
+Three layers communicating over a Unix socket (`~/.sisyphus/daemon.sock`):
+
+- **CLI** (`sisyphus`) — Commander.js program that sends JSON requests to the daemon
+- **Daemon** (`sisyphusd`) — Manages sessions, spawns/monitors tmux panes, tracks state
+- **Shared** — Types, protocol definitions, config resolution
+
+State is persisted as JSON at `.sisyphus/sessions/{id}/state.json` (relative to your project directory), written atomically via temp file + rename.
+
+## Configuration
+
+Config is layered: project (`.sisyphus/config.json`) overrides global (`~/.sisyphus/config.json`).
+
+```json
+{
+  "model": "sonnet",
+  "pollIntervalMs": 3000
+}
+```
+
+You can also override the orchestrator prompt per-project by placing a file at `.sisyphus/orchestrator.md`.
+
+## License
+
+MIT

package/dist/chunk-5WP7O7D3.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+// src/shared/paths.ts
+import { homedir } from "os";
+import { join } from "path";
+function globalDir() {
+  return join(homedir(), ".sisyphus");
+}
+function socketPath() {
+  return join(globalDir(), "daemon.sock");
+}
+function globalConfigPath() {
+  return join(globalDir(), "config.json");
+}
+function daemonPidPath() {
+  return join(globalDir(), "daemon.pid");
+}
+function projectDir(cwd) {
+  return join(cwd, ".sisyphus");
+}
+function projectConfigPath(cwd) {
+  return join(projectDir(cwd), "config.json");
+}
+function projectOrchestratorPromptPath(cwd) {
+  return join(projectDir(cwd), "orchestrator.md");
+}
+function sessionsDir(cwd) {
+  return join(projectDir(cwd), "sessions");
+}
+function sessionDir(cwd, sessionId) {
+  return join(sessionsDir(cwd), sessionId);
+}
+function statePath(cwd, sessionId) {
+  return join(sessionDir(cwd, sessionId), "state.json");
+}
+function reportsDir(cwd, sessionId) {
+  return join(sessionDir(cwd, sessionId), "reports");
+}
+function reportFilePath(cwd, sessionId, agentId, suffix) {
+  return join(reportsDir(cwd, sessionId), `${agentId}-${suffix}.md`);
+}
+
+export {
+  globalDir,
+  socketPath,
+  globalConfigPath,
+  daemonPidPath,
+  projectConfigPath,
+  projectOrchestratorPromptPath,
+  sessionsDir,
+  sessionDir,
+  statePath,
+  reportsDir,
+  reportFilePath
+};
+//# sourceMappingURL=chunk-5WP7O7D3.js.map

package/dist/chunk-5WP7O7D3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/paths.ts"],"sourcesContent":["import { homedir } from 'node:os';\nimport { join } from 'node:path';\n\nexport function globalDir(): string {\n  return join(homedir(), '.sisyphus');\n}\n\nexport function socketPath(): string {\n  return join(globalDir(), 'daemon.sock');\n}\n\nexport function globalConfigPath(): string {\n  return join(globalDir(), 'config.json');\n}\n\nexport function daemonLogPath(): string {\n  return join(globalDir(), 'daemon.log');\n}\n\nexport function daemonPidPath(): string {\n  return join(globalDir(), 'daemon.pid');\n}\n\nexport function projectDir(cwd: string): string {\n  return join(cwd, '.sisyphus');\n}\n\nexport function projectConfigPath(cwd: string): string {\n  return join(projectDir(cwd), 'config.json');\n}\n\nexport function projectOrchestratorPromptPath(cwd: string): string {\n  return join(projectDir(cwd), 'orchestrator.md');\n}\n\nexport function sessionsDir(cwd: string): string {\n  return join(projectDir(cwd), 'sessions');\n}\n\nexport function sessionDir(cwd: string, sessionId: string): string {\n  return join(sessionsDir(cwd), sessionId);\n}\n\nexport function statePath(cwd: string, sessionId: string): string {\n  return join(sessionDir(cwd, sessionId), 'state.json');\n}\n\nexport function reportsDir(cwd: string, sessionId: string): string {\n  return join(sessionDir(cwd, sessionId), 'reports');\n}\n\nexport function reportFilePath(cwd: string, sessionId: string, agentId: string, suffix: string): string {\n  return join(reportsDir(cwd, sessionId), `${agentId}-${suffix}.md`);\n}\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,SAAS,YAAY;AAEd,SAAS,YAAoB;AAClC,SAAO,KAAK,QAAQ,GAAG,WAAW;AACpC;AAEO,SAAS,aAAqB;AACnC,SAAO,KAAK,UAAU,GAAG,aAAa;AACxC;AAEO,SAAS,mBAA2B;AACzC,SAAO,KAAK,UAAU,GAAG,aAAa;AACxC;AAMO,SAAS,gBAAwB;AACtC,SAAO,KAAK,UAAU,GAAG,YAAY;AACvC;AAEO,SAAS,WAAW,KAAqB;AAC9C,SAAO,KAAK,KAAK,WAAW;AAC9B;AAEO,SAAS,kBAAkB,KAAqB;AACrD,SAAO,KAAK,WAAW,GAAG,GAAG,aAAa;AAC5C;AAEO,SAAS,8BAA8B,KAAqB;AACjE,SAAO,KAAK,WAAW,GAAG,GAAG,iBAAiB;AAChD;AAEO,SAAS,YAAY,KAAqB;AAC/C,SAAO,KAAK,WAAW,GAAG,GAAG,UAAU;AACzC;AAEO,SAAS,WAAW,KAAa,WAA2B;AACjE,SAAO,KAAK,YAAY,GAAG,GAAG,SAAS;AACzC;AAEO,SAAS,UAAU,KAAa,WAA2B;AAChE,SAAO,KAAK,WAAW,KAAK,SAAS,GAAG,YAAY;AACtD;AAEO,SAAS,WAAW,KAAa,WAA2B;AACjE,SAAO,KAAK,WAAW,KAAK,SAAS,GAAG,SAAS;AACnD;AAEO,SAAS,eAAe,KAAa,WAAmB,SAAiB,QAAwB;AACtG,SAAO,KAAK,WAAW,KAAK,SAAS,GAAG,GAAG,OAAO,IAAI,MAAM,KAAK;AACnE;","names":[]}