dev-sessions 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# dev-sessions
+
+A CLI tool for coding agents to spawn, manage, and communicate with other coding agent sessions. Built for agent-to-agent delegation — no MCP overhead, just a CLI that agents call via Bash.
+
+## Why
+
+Coding agents (Claude Code, Codex) are increasingly capable of orchestrating parallel work. But the tooling for agent-to-agent communication is either over-engineered (MCP servers, HTTP gateways, SSH tunnels) or too primitive (raw tmux commands).
+
+`dev-sessions` provides a clean CLI interface that lets agents:
+- **Spawn** new coding agent sessions (Claude Code or Codex)
+- **Send** tasks and messages to those sessions
+- **Wait** for turns to complete (transcript-aware, not terminal scraping)
+- **Read** structured responses (clean assistant text, not ANSI noise)
+- **Check status** (idle, working, waiting for input)
+
+## Architecture
+
+### Claude Code Sessions
+- **Backend**: tmux (human-attachable via `tmux attach -t dev-<id>`)
+- **Session ID**: Pre-assigned UUID via `claude --session-id <uuid>`
+- **Transcript**: `~/.claude/projects/<encoded-path>/<uuid>.jsonl`
+- **Message delivery**: tmux send-keys (base64 encoded for safety)
+- **Turn detection**: Watches for `system` entries in JSONL transcript (definitive turn-completion signal)
+
+### Codex Sessions
+- **Backend**: Persistent `codex app-server` daemon (JSON-RPC 2.0 over WebSocket)
+- **Session ID**: Thread ID from `thread/start` response
+- **Conversation continuity**: Multiple sends share the same thread — full conversation history preserved
+- **Message delivery**: `turn/start` JSON-RPC call
+- **Turn detection**: `turn/completed` notification (streaming, no polling)
+- **Daemon lifecycle**: Auto-started on first `create --cli codex`, auto-stopped when last Codex session is killed
+
+## Usage
+
+```bash
+# Create a session (defaults: --cli claude, --mode yolo)
+dev-sessions create --description "refactor auth module"
+# => fizz-top
+
+# Send a task
+dev-sessions send fizz-top "Implement JWT auth. See AUTH-SPEC.md for details."
+dev-sessions send fizz-top --file BRIEFING.md
+
+# Wait for the agent to finish its turn
+dev-sessions wait fizz-top --timeout 300
+
+# Get the agent's response (clean text, not terminal noise)
+dev-sessions last-message fizz-top
+
+# Check what's happening
+dev-sessions status fizz-top    # idle | working | waiting_for_input
+dev-sessions list               # all active sessions
+
+# Synchronous delegation (one-liner)
+sid=$(dev-sessions create -q) && dev-sessions send $sid "run tests and fix failures" && dev-sessions wait $sid && dev-sessions last-message $sid
+
+# Fan-out
+s1=$(dev-sessions create -q --description "frontend")
+s2=$(dev-sessions create -q --description "backend")
+dev-sessions send $s1 "build React form per SPEC.md"
+dev-sessions send $s2 "add /api/users endpoint per SPEC.md"
+dev-sessions wait $s1
+dev-sessions wait $s2
+dev-sessions last-message $s1
+dev-sessions last-message $s2
+
+# Codex session (persistent app-server, conversation continuity)
+sid=$(dev-sessions create --cli codex -q)
+dev-sessions send $sid "hello"
+dev-sessions send $sid "what did I just say?"   # has context from first message
+dev-sessions last-message $sid                   # "You said hello"
+
+# Clean up
+dev-sessions kill fizz-top
+```
+
+## Installation
+
+```bash
+npm install -g dev-sessions
+```
+
+Or clone and link:
+```bash
+git clone <repo-url>
+cd dev-sessions
+npm install && npm run build && npm link
+```
+
+### Skill Installation (Optional)
+
+Install the `/dev-sessions` skill for Claude Code and/or Codex:
+```bash
+dev-sessions install-skill --global            # Auto-detect available tools
+dev-sessions install-skill --global --claude    # Claude Code only
+dev-sessions install-skill --global --codex     # Codex CLI only
+dev-sessions install-skill --local              # Current directory only
+```
+
+The skill teaches agents best practices for task delegation, polling strategies, and fan-out patterns.
+
+## Modes
+
+| Mode | Flag | Description |
+|------|------|-------------|
+| `yolo` | `--mode yolo` | Runs CLI with permission bypass flags (default) |
+| `native` | `--mode native` | Runs CLI normally (will prompt for permissions) |
+| `docker` | `--mode docker` | Runs via `clauded` Docker wrapper (Claude Code only) |
+
+## Docker Integration
+
+When running inside a Docker container (detected via `IS_SANDBOX=1`), the CLI automatically routes commands through an HTTP gateway relay on the host.
+
+**Setup:**
+1. Start the gateway on the host: `dev-sessions gateway --port 6767`
+2. Inside Docker, the CLI detects `IS_SANDBOX=1` and uses `DEV_SESSIONS_GATEWAY_URL` (default `http://host.docker.internal:6767`)
+3. `HOST_PATH` maps the container workspace to the host filesystem
+
+This is an optional integration for users of [claude-ting](https://github.com/anthropics/claude-ting) Docker workflows. The CLI works natively on the host without any gateway.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `create [options]` | Spawn a new agent session (`--cli claude\|codex`, `--mode yolo\|native\|docker`, `-q` for quiet) |
+| `send <id> <msg>` | Send a message to a session (`--file` to send file contents) |
+| `wait <id>` | Block until current turn completes (`--timeout` in seconds) |
+| `last-message <id>` | Get last assistant message(s) from transcript (`--count N`) |
+| `status <id>` | Get session status: `idle`, `working`, or `waiting_for_input` |
+| `list` | List all active sessions |
+| `kill <id>` | Terminate a session and clean up |
+| `gateway` | Start the Docker relay gateway HTTP server (`--port`) |
+| `install-skill` | Install the /dev-sessions skill (`--global\|--local`, `--claude\|--codex`) |
+
+## Session Lifecycle
+
+```
+create  →  send  →  [wait / poll status]  →  last-message  →  kill
+                ↑                                    |
+                └────────────────────────────────────┘
+                        (send follow-up)
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test                  # unit + integration tests (83 tests)
+npm run test:integration  # integration tests only
+npm link                  # for local CLI testing
+```
+
+## License
+
+MIT

package/dist/backends/claude-tmux.d.ts

@@ -0,0 +1,19 @@
+import { SessionMode } from '../types';
+export declare class ClaudeTmuxBackend {
+    private readonly timeoutMs;
+    constructor(timeoutMs?: number);
+    createSession(tmuxSessionName: string, workspacePath: string, mode: SessionMode, sessionUuid: string): Promise<void>;
+    sendMessage(tmuxSessionName: string, message: string): Promise<void>;
+    submitInput(tmuxSessionName: string): Promise<void>;
+    killSession(tmuxSessionName: string): Promise<void>;
+    listSessions(): Promise<string[]>;
+    sessionExists(tmuxSessionName: string): Promise<boolean>;
+    isClaudeRunning(tmuxSessionName: string): Promise<boolean>;
+    isCliRunning(tmuxSessionName: string, commandPatterns?: RegExp[]): Promise<boolean>;
+    private getPaneCommands;
+    private isUserCliProcess;
+    private buildStartupCommand;
+    private execTmux;
+    private execCommand;
+    private sleep;
+}

package/dist/backends/claude-tmux.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeTmuxBackend = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const SHELL_COMMAND_PATTERN = /(^|\s|\/)-?(bash|zsh|sh|fish)(\s|$)/;
+const CONTROL_COMMAND_PATTERN = /(^|\s|\/)(tmux|login)(\s|$)/;
+function shellEscape(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+class ClaudeTmuxBackend {
+    timeoutMs;
+    constructor(timeoutMs = 15_000) {
+        this.timeoutMs = timeoutMs;
+    }
+    async createSession(tmuxSessionName, workspacePath, mode, sessionUuid) {
+        const startupCommand = this.buildStartupCommand(workspacePath, mode, sessionUuid);
+        await this.execTmux([
+            'new-session',
+            '-d',
+            '-s',
+            tmuxSessionName,
+            '-n',
+            tmuxSessionName,
+            'bash',
+            '-lc',
+            startupCommand
+        ]);
+        if (mode === 'docker') {
+            await this.sleep(5000);
+            await this.execTmux(['send-keys', '-t', tmuxSessionName, 'C-m']);
+        }
+    }
+    async sendMessage(tmuxSessionName, message) {
+        if (!(await this.isClaudeRunning(tmuxSessionName))) {
+            throw new Error('Claude is not running in this tmux session - refusing to send message');
+        }
+        const encodedMessage = Buffer.from(message, 'utf8').toString('base64');
+        const sessionTarget = shellEscape(tmuxSessionName);
+        const encoded = shellEscape(encodedMessage);
+        const script = [
+            `decoded=$( (printf '%s' ${encoded} | base64 --decode 2>/dev/null) || (printf '%s' ${encoded} | base64 -D) )`,
+            `tmux send-keys -l -t ${sessionTarget} "$decoded"`
+        ].join('\n');
+        await this.execCommand('bash', ['-lc', script], 30_000);
+        // Small gaps mirror the original SSH gateway timing and improve submit reliability.
+        await this.sleep(75);
+        // Keep Enter presses as separate tmux commands to match the original gateway behavior.
+        await this.execTmux(['send-keys', '-t', tmuxSessionName, 'C-m']);
+        await this.sleep(150);
+        await this.execTmux(['send-keys', '-t', tmuxSessionName, 'C-m']);
+    }
+    async submitInput(tmuxSessionName) {
+        if (!(await this.isClaudeRunning(tmuxSessionName))) {
+            throw new Error('Claude is not running in this tmux session - refusing to submit input');
+        }
+        await this.execTmux(['send-keys', '-t', tmuxSessionName, 'C-m']);
+    }
+    async killSession(tmuxSessionName) {
+        await this.execTmux(['kill-session', '-t', tmuxSessionName]);
+    }
+    async listSessions() {
+        try {
+            const output = await this.execTmux(['list-sessions', '-F', '#{session_name}']);
+            return output
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    async sessionExists(tmuxSessionName) {
+        try {
+            await this.execTmux(['has-session', '-t', tmuxSessionName]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isClaudeRunning(tmuxSessionName) {
+        return this.isCliRunning(tmuxSessionName, [
+            /(^|\s|\/)(claude|clauded)(\s|$)/,
+            /docker.*ubuntu-dev/
+        ]);
+    }
+    async isCliRunning(tmuxSessionName, commandPatterns = []) {
+        try {
+            const paneCommands = await this.getPaneCommands(tmuxSessionName);
+            if (commandPatterns.length > 0) {
+                return paneCommands.some((command) => commandPatterns.some((pattern) => pattern.test(command)));
+            }
+            return paneCommands.some((command) => this.isUserCliProcess(command));
+        }
+        catch {
+            return false;
+        }
+    }
+    async getPaneCommands(tmuxSessionName) {
+        const paneOutput = await this.execTmux(['list-panes', '-t', tmuxSessionName, '-F', '#{pane_tty}']);
+        const paneTtys = paneOutput
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+        const commands = [];
+        for (const paneTty of paneTtys) {
+            const ttyName = node_path_1.default.basename(paneTty);
+            let psOutput = '';
+            try {
+                psOutput = await this.execCommand('ps', ['-t', ttyName, '-o', 'command=']);
+            }
+            catch {
+                continue;
+            }
+            const ttyCommands = psOutput
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0);
+            commands.push(...ttyCommands);
+        }
+        return commands;
+    }
+    isUserCliProcess(command) {
+        if (command.length === 0) {
+            return false;
+        }
+        return !SHELL_COMMAND_PATTERN.test(command) && !CONTROL_COMMAND_PATTERN.test(command);
+    }
+    buildStartupCommand(workspacePath, mode, sessionUuid) {
+        const binary = mode === 'docker' ? 'clauded' : 'claude';
+        const commandParts = [`${binary} --session-id ${shellEscape(sessionUuid)}`];
+        if (mode === 'yolo') {
+            commandParts.push('--dangerously-skip-permissions');
+        }
+        return `cd ${shellEscape(workspacePath)} && ${commandParts.join(' ')}`;
+    }
+    async execTmux(args) {
+        return this.execCommand('tmux', args);
+    }
+    async execCommand(command, args, timeoutMs = this.timeoutMs) {
+        const { stdout } = await execFileAsync(command, args, {
+            encoding: 'utf8',
+            timeout: timeoutMs,
+            maxBuffer: 1024 * 1024 * 4
+        });
+        return stdout;
+    }
+    async sleep(ms) {
+        await new Promise((resolve) => {
+            setTimeout(resolve, ms);
+        });
+    }
+}
+exports.ClaudeTmuxBackend = ClaudeTmuxBackend;
+//# sourceMappingURL=claude-tmux.js.map

package/dist/backends/claude-tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-tmux.js","sourceRoot":"","sources":["../../src/backends/claude-tmux.ts"],"names":[],"mappings":"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"}

package/dist/backends/codex-appserver.d.ts

@@ -0,0 +1,71 @@
+import { AgentTurnStatus } from '../types';
+type TurnCompletionStatus = 'completed' | 'failed' | 'interrupted';
+export interface CodexAppServerInfo {
+    pid: number;
+    port: number;
+    url: string;
+}
+export interface CodexSessionCreateResult {
+    threadId: string;
+    model: string;
+    appServerPid: number;
+    appServerPort: number;
+}
+export interface CodexTurnWaitResult {
+    completed: boolean;
+    timedOut: boolean;
+    elapsedMs: number;
+    status: TurnCompletionStatus;
+    errorMessage?: string;
+}
+export interface CodexSendMessageOptions {
+    workspacePath: string;
+    model?: string;
+    timeoutMs?: number;
+}
+export interface CodexTurnSendResult extends CodexTurnWaitResult {
+    threadId: string;
+    assistantMessage: string;
+    appServerPid: number;
+    appServerPort: number;
+}
+export interface CodexRpcClient {
+    readonly currentTurnText: string;
+    readonly lastTurnStatus?: TurnCompletionStatus;
+    readonly lastTurnError?: string;
+    connectAndInitialize(): Promise<void>;
+    request(method: string, params?: unknown): Promise<unknown>;
+    waitForTurnCompletion(timeoutMs: number): Promise<CodexTurnWaitResult>;
+    close(): Promise<void>;
+}
+export interface CodexAppServerDaemonManager {
+    ensureServer(): Promise<CodexAppServerInfo>;
+    getServer(): Promise<CodexAppServerInfo | undefined>;
+    isServerRunning(pid?: number, port?: number): Promise<boolean>;
+    resetServer(server?: CodexAppServerInfo): Promise<void>;
+    stopServer(): Promise<void>;
+}
+export interface CodexAppServerBackendDependencies {
+    clientFactory?: (url: string) => CodexRpcClient;
+    daemonManager?: CodexAppServerDaemonManager;
+}
+export declare class CodexAppServerBackend {
+    private readonly sessionState;
+    private readonly daemonManager;
+    private readonly clientFactory;
+    constructor(dependencies?: CodexAppServerBackendDependencies);
+    createSession(championId: string, workspacePath: string, model?: string): Promise<CodexSessionCreateResult>;
+    sendMessage(championId: string, threadId: string, message: string, options?: CodexSendMessageOptions): Promise<CodexTurnSendResult>;
+    waitForTurn(championId: string, timeoutMs?: number): Promise<CodexTurnWaitResult>;
+    getLastAssistantMessages(championId: string, count: number): string[];
+    getSessionStatus(championId: string): AgentTurnStatus;
+    killSession(championId: string, pid?: number, threadId?: string, port?: number): Promise<void>;
+    stopAppServer(): Promise<void>;
+    sessionExists(_championId: string, pid?: number, port?: number): Promise<boolean>;
+    private ensureSessionState;
+    private withConnectedClient;
+    private withConnectedClientToServer;
+    private shouldResetDaemonAfterConnectionFailure;
+    private isResumeNotFoundError;
+}
+export {};