@jlongo78/agent-spaces 0.7.5 → 0.7.7

package/README.md

@@ -1,131 +1,131 @@
-<p align="center">
-  <img src="public/spaces_logo.png" alt="Spaces" width="420" />
-</p>
-
-<h3 align="center">The workspace manager for AI coding agents</h3>
-
-<p align="center">
-  Run Claude Code, Codex CLI, Gemini CLI, Aider, or any agent side-by-side<br/>
-  in a browser-based terminal grid. Totally free. Totally open source.
-</p>
-
-<p align="center">
-  <a href="#quick-start">Quick Start</a> &middot;
-  <a href="#features">Features</a> &middot;
-  <a href="docs/getting-started.md">Full Docs</a>
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@jlongo78/agent-spaces"><img src="https://img.shields.io/npm/v/@jlongo78/agent-spaces?style=flat-square&color=cb3837" alt="npm" /></a>
-  <a href="https://github.com/jlongo78/spaces/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/jlongo78/spaces/ci.yml?style=flat-square&label=CI" alt="CI" /></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT License" /></a>
-  <img src="https://img.shields.io/badge/node-%3E%3D20.9-brightgreen?style=flat-square" alt="Node 20.9+" />
-  <img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20ARM64-lightgrey?style=flat-square" alt="Platforms" />
-</p>
-
-<p align="center">
-  <img src="public/demo.gif" alt="Spaces demo" width="800" />
-</p>
-
----
-
-## What is Spaces?
-
-Most AI coding agents are powerful but isolated — one terminal, one session, one agent at a time. **Spaces** changes that.
-
-Open your browser and get a full terminal grid where every pane is a real PTY. Spin up Claude in one pane, Codex in another, a plain shell in a third. Group them into named workspaces. Search across every session you've ever had. See your usage stats at a glance.
-
-Everything runs locally. Your data never leaves your machine.
-
-## Quick Start
-
-### Install from npm (recommended)
-
-```bash
-npm install -g @jlongo78/agent-spaces
-spaces
-```
-
-### Or build from source
-
-```bash
-git clone https://github.com/jlongo78/spaces.git
-cd spaces
-npm install
-npm run build
-npm start
-```
-
-Open [http://localhost:3457](http://localhost:3457) and start adding panes.
-
-## Features
-
-### Terminal Multiplexer
-Split your browser into a grid of terminal panes. Each one runs a real PTY streamed over WebSocket to xterm.js — not a toy emulator.
-
-### Agent-Agnostic
-First-class support for **Claude Code**, **Codex CLI**, **Gemini CLI**, **Aider**, any custom command, and plain shell. Pick your agent per-pane from a dropdown.
-
-### Workspaces
-Group panes into named, color-coded spaces. Working on the frontend and the API at the same time? Give each its own workspace and switch instantly.
-
-### Session Browser
-Every agent session (Claude, Codex, Gemini, Aider) is indexed automatically. Browse, search, and filter with full-text search powered by SQLite FTS5. Jump back into any conversation.
-
-### Dashboard & Analytics
-Session counts, token usage breakdown by model, activity heatmap, and cost estimates — all computed locally from your `~/.claude/` data.
-
-### Everything Local
-Zero cloud dependencies. No accounts. No telemetry by default. All data lives in `~/.claude/` (read-only) and `~/.spaces/` (auto-created). Fully offline-capable.
-
-## Advanced Tiers
-
-The Community edition above is fully open source (MIT) and free forever. For teams and organizations, Spaces also supports multi-user auth, admin panels, federated node networks, and remote workspaces through optional paid tiers.
-
-| | Community | Server | Team | Federation |
-|---|:---------:|:------:|:----:|:----------:|
-| Multi-pane terminals | Yes | Yes | Yes | Yes |
-| Session browser & search | Yes | Yes | Yes | Yes |
-| Dashboard & analytics | Yes | Yes | Yes | Yes |
-| Browser access | Yes | Yes | Yes | Yes |
-| Login & TOTP auth | - | Yes | Yes | Yes |
-| Multi-user accounts | - | - | Yes | Yes |
-| Admin panel | - | - | Yes | Yes |
-| Federated node network | - | - | - | Yes |
-| Remote workspaces | - | - | - | Yes |
-| mDNS auto-discovery | - | - | - | Yes |
-
-See [docs/tiers.md](docs/tiers.md) for details.
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|------------|
-| Framework | Next.js 16 (App Router) |
-| UI | React 19, Tailwind CSS, Lucide icons |
-| Database | SQLite via better-sqlite3, FTS5 full-text search |
-| Terminal | xterm.js + node-pty over WebSocket |
-| Runtime | Node.js (CLI) |
-
-## Configuration
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `SPACES_PORT` | `3457` | Web UI port |
-| `SPACES_WS_PORT` | `3458` | Terminal WebSocket port |
-| `NEXT_PUBLIC_TIER` | `community` | Product tier |
-
-Data lives in:
-- **`~/.claude/`** — Claude Code sessions (read-only)
-- **`~/.codex/`** — Codex CLI sessions (read-only)
-- **`~/.gemini/`** — Gemini CLI sessions (read-only)
-- **`.aider.chat.history.md`** — Aider sessions in each project directory (read-only)
-- **`~/.spaces/`** — Spaces database and config (auto-created)
-
-## Contributing
-
-Contributions are welcome. Please open an issue first to discuss what you'd like to change.
-
-## License
-
-[MIT](LICENSE)
+<p align="center">
+  <img src="public/spaces_logo.png" alt="Spaces" width="420" />
+</p>
+
+<h3 align="center">The workspace manager for AI coding agents</h3>
+
+<p align="center">
+  Run Claude Code, Codex CLI, Gemini CLI, Aider, or any agent side-by-side<br/>
+  in a browser-based terminal grid. Totally free. Totally open source.
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> &middot;
+  <a href="#features">Features</a> &middot;
+  <a href="docs/getting-started.md">Full Docs</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@jlongo78/agent-spaces"><img src="https://img.shields.io/npm/v/@jlongo78/agent-spaces?style=flat-square&color=cb3837" alt="npm" /></a>
+  <a href="https://github.com/jlongo78/spaces/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/jlongo78/spaces/ci.yml?style=flat-square&label=CI" alt="CI" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT License" /></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D20.9-brightgreen?style=flat-square" alt="Node 20.9+" />
+  <img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20ARM64-lightgrey?style=flat-square" alt="Platforms" />
+</p>
+
+<p align="center">
+  <img src="public/demo.gif" alt="Spaces demo" width="800" />
+</p>
+
+---
+
+## What is Spaces?
+
+Most AI coding agents are powerful but isolated — one terminal, one session, one agent at a time. **Spaces** changes that.
+
+Open your browser and get a full terminal grid where every pane is a real PTY. Spin up Claude in one pane, Codex in another, a plain shell in a third. Group them into named workspaces. Search across every session you've ever had. See your usage stats at a glance.
+
+Everything runs locally. Your data never leaves your machine.
+
+## Quick Start
+
+### Install from npm (recommended)
+
+```bash
+npm install -g @jlongo78/agent-spaces
+spaces
+```
+
+### Or build from source
+
+```bash
+git clone https://github.com/jlongo78/spaces.git
+cd spaces
+npm install
+npm run build
+npm start
+```
+
+Open [http://localhost:3457](http://localhost:3457) and start adding panes.
+
+## Features
+
+### Terminal Multiplexer
+Split your browser into a grid of terminal panes. Each one runs a real PTY streamed over WebSocket to xterm.js — not a toy emulator.
+
+### Agent-Agnostic
+First-class support for **Claude Code**, **Codex CLI**, **Gemini CLI**, **Aider**, any custom command, and plain shell. Pick your agent per-pane from a dropdown.
+
+### Workspaces
+Group panes into named, color-coded spaces. Working on the frontend and the API at the same time? Give each its own workspace and switch instantly.
+
+### Session Browser
+Every agent session (Claude, Codex, Gemini, Aider) is indexed automatically. Browse, search, and filter with full-text search powered by SQLite FTS5. Jump back into any conversation.
+
+### Dashboard & Analytics
+Session counts, token usage breakdown by model, activity heatmap, and cost estimates — all computed locally from your `~/.claude/` data.
+
+### Everything Local
+Zero cloud dependencies. No accounts. No telemetry by default. All data lives in `~/.claude/` (read-only) and `~/.spaces/` (auto-created). Fully offline-capable.
+
+## Advanced Tiers
+
+The Community edition above is fully open source (MIT) and free forever. For teams and organizations, Spaces also supports multi-user auth, admin panels, federated node networks, and remote workspaces through optional paid tiers.
+
+| | Community | Server | Team | Federation |
+|---|:---------:|:------:|:----:|:----------:|
+| Multi-pane terminals | Yes | Yes | Yes | Yes |
+| Session browser & search | Yes | Yes | Yes | Yes |
+| Dashboard & analytics | Yes | Yes | Yes | Yes |
+| Browser access | Yes | Yes | Yes | Yes |
+| Login & TOTP auth | - | Yes | Yes | Yes |
+| Multi-user accounts | - | - | Yes | Yes |
+| Admin panel | - | - | Yes | Yes |
+| Federated node network | - | - | - | Yes |
+| Remote workspaces | - | - | - | Yes |
+| mDNS auto-discovery | - | - | - | Yes |
+
+See [docs/tiers.md](docs/tiers.md) for details.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Framework | Next.js 16 (App Router) |
+| UI | React 19, Tailwind CSS, Lucide icons |
+| Database | SQLite via better-sqlite3, FTS5 full-text search |
+| Terminal | xterm.js + node-pty over WebSocket |
+| Runtime | Node.js (CLI) |
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SPACES_PORT` | `3457` | Web UI port |
+| `SPACES_WS_PORT` | `3458` | Terminal WebSocket port |
+| `NEXT_PUBLIC_TIER` | `community` | Product tier |
+
+Data lives in:
+- **`~/.claude/`** — Claude Code sessions (read-only)
+- **`~/.codex/`** — Codex CLI sessions (read-only)
+- **`~/.gemini/`** — Gemini CLI sessions (read-only)
+- **`.aider.chat.history.md`** — Aider sessions in each project directory (read-only)
+- **`~/.spaces/`** — Spaces database and config (auto-created)
+
+## Contributing
+
+Contributions are welcome. Please open an issue first to discuss what you'd like to change.
+
+## License
+
+[MIT](LICENSE)

package/bin/cortex-hook.sh

@@ -1,62 +1,62 @@
-#!/bin/bash
-# Cortex RAG hook for Claude Code
-# Receives user prompt via stdin JSON, queries Cortex for relevant context,
-# returns it as additionalContext so Claude sees it alongside the prompt.
-set -e
-
-# Read JSON input from stdin
-INPUT=$(cat)
-
-PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty')
-CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
-
-# Skip empty or very short prompts (not worth a RAG search)
-if [ -z "$PROMPT" ] || [ ${#PROMPT} -lt 10 ]; then
-  exit 0
-fi
-
-# Resolve API port and auth
-API_PORT="${SPACES_PORT:-3457}"
-SECRET="${SPACES_SESSION_SECRET:-}"
-INTERNAL_TOKEN="${SECRET:0:16}"
-
-# URL-encode the prompt (basic: replace spaces and common chars)
-ENCODED_PROMPT=$(python3 -c "import urllib.parse, sys; print(urllib.parse.quote(sys.argv[1]))" "$PROMPT" 2>/dev/null \
-  || node -e "process.stdout.write(encodeURIComponent(process.argv[1]))" "$PROMPT" 2>/dev/null \
-  || echo "$PROMPT" | sed 's/ /%20/g')
-
-# Query Cortex search API
-RESPONSE=$(curl -s -m 5 \
-  -H "x-spaces-internal: ${INTERNAL_TOKEN}" \
-  "http://localhost:${API_PORT}/api/cortex/search/?q=${ENCODED_PROMPT}&limit=5" 2>/dev/null || echo '{}')
-
-# Check if we got results
-RESULT_COUNT=$(echo "$RESPONSE" | jq -r '.results | length // 0' 2>/dev/null || echo "0")
-
-if [ "$RESULT_COUNT" = "0" ] || [ "$RESULT_COUNT" = "null" ]; then
-  exit 0
-fi
-
-# Format the results into readable context
-CONTEXT=$(echo "$RESPONSE" | jq -r '
-  .results[:5] | to_entries | map(
-    .value |
-    "[" + (.type // "context") + "] " +
-    (if .source_timestamp then (.source_timestamp | split("T")[0]) + ": " else "" end) +
-    .text
-  ) | join("\n\n")
-' 2>/dev/null || echo "")
-
-if [ -z "$CONTEXT" ]; then
-  exit 0
-fi
-
-# Return as additionalContext
-jq -n --arg context "$CONTEXT" '{
-  "hookSpecificOutput": {
-    "hookEventName": "UserPromptSubmit",
-    "additionalContext": ("<cortex-context>\nRelevant knowledge from your workspace history:\n\n" + $context + "\n</cortex-context>")
-  }
-}'
-
-exit 0
+#!/bin/bash
+# Cortex RAG hook for Claude Code
+# Receives user prompt via stdin JSON, queries Cortex for relevant context,
+# returns it as additionalContext so Claude sees it alongside the prompt.
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty')
+CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
+
+# Skip empty or very short prompts (not worth a RAG search)
+if [ -z "$PROMPT" ] || [ ${#PROMPT} -lt 10 ]; then
+  exit 0
+fi
+
+# Resolve API port and auth
+API_PORT="${SPACES_PORT:-3457}"
+SECRET="${SPACES_SESSION_SECRET:-}"
+INTERNAL_TOKEN="${SECRET:0:16}"
+
+# URL-encode the prompt (basic: replace spaces and common chars)
+ENCODED_PROMPT=$(python3 -c "import urllib.parse, sys; print(urllib.parse.quote(sys.argv[1]))" "$PROMPT" 2>/dev/null \
+  || node -e "process.stdout.write(encodeURIComponent(process.argv[1]))" "$PROMPT" 2>/dev/null \
+  || echo "$PROMPT" | sed 's/ /%20/g')
+
+# Query Cortex search API
+RESPONSE=$(curl -s -m 5 \
+  -H "x-spaces-internal: ${INTERNAL_TOKEN}" \
+  "http://localhost:${API_PORT}/api/cortex/search/?q=${ENCODED_PROMPT}&limit=5" 2>/dev/null || echo '{}')
+
+# Check if we got results
+RESULT_COUNT=$(echo "$RESPONSE" | jq -r '.results | length // 0' 2>/dev/null || echo "0")
+
+if [ "$RESULT_COUNT" = "0" ] || [ "$RESULT_COUNT" = "null" ]; then
+  exit 0
+fi
+
+# Format the results into readable context
+CONTEXT=$(echo "$RESPONSE" | jq -r '
+  .results[:5] | to_entries | map(
+    .value |
+    "[" + (.type // "context") + "] " +
+    (if .source_timestamp then (.source_timestamp | split("T")[0]) + ": " else "" end) +
+    .text
+  ) | join("\n\n")
+' 2>/dev/null || echo "")
+
+if [ -z "$CONTEXT" ]; then
+  exit 0
+fi
+
+# Return as additionalContext
+jq -n --arg context "$CONTEXT" '{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": ("<cortex-context>\nRelevant knowledge from your workspace history:\n\n" + $context + "\n</cortex-context>")
+  }
+}'
+
+exit 0

package/bin/cortex-mcp.js

@@ -1,60 +1,60 @@
-#!/usr/bin/env node
-'use strict';
-
-const readline = require('readline');
-
-const SPACES_URL = process.env.SPACES_URL || 'http://localhost:3457';
-const INTERNAL_TOKEN = process.env.SPACES_INTERNAL_TOKEN || '';
-
-const rl = readline.createInterface({ input: process.stdin });
-
-rl.on('line', async (line) => {
-  let msg;
-  try { msg = JSON.parse(line); } catch { return; }
-
-  if (msg.method === 'initialize') {
-    respond(msg.id, {
-      protocolVersion: '2024-11-05',
-      capabilities: { tools: { listChanged: false } },
-      serverInfo: { name: 'cortex', version: '1.0.0' },
-    });
-    return;
-  }
-
-  if (msg.method === 'notifications/initialized') return;
-
-  if (msg.method === 'tools/list') {
-    const tools = await fetchJSON('/api/cortex/mcp/tools');
-    respond(msg.id, { tools: tools || [] });
-    return;
-  }
-
-  if (msg.method === 'tools/call') {
-    const { name, arguments: args } = msg.params;
-    const result = await fetchJSON('/api/cortex/mcp/call', {
-      method: 'POST',
-      body: JSON.stringify({ name, args }),
-    });
-    respond(msg.id, result || { content: [{ type: 'text', text: 'Error calling tool' }], isError: true });
-    return;
-  }
-
-  respond(msg.id, null, { code: -32601, message: `Method not found: ${msg.method}` });
-});
-
-function respond(id, result, error) {
-  const msg = { jsonrpc: '2.0', id };
-  if (error) msg.error = error;
-  else msg.result = result;
-  process.stdout.write(JSON.stringify(msg) + '\n');
-}
-
-async function fetchJSON(path, opts = {}) {
-  try {
-    const headers = { 'Content-Type': 'application/json' };
-    if (INTERNAL_TOKEN) headers['x-spaces-internal'] = INTERNAL_TOKEN;
-    const res = await fetch(`${SPACES_URL}${path}`, { ...opts, headers: { ...headers, ...opts.headers } });
-    if (res.ok) return await res.json();
-    return null;
-  } catch { return null; }
-}
+#!/usr/bin/env node
+'use strict';
+
+const readline = require('readline');
+
+const SPACES_URL = process.env.SPACES_URL || 'http://localhost:3457';
+const INTERNAL_TOKEN = process.env.SPACES_INTERNAL_TOKEN || '';
+
+const rl = readline.createInterface({ input: process.stdin });
+
+rl.on('line', async (line) => {
+  let msg;
+  try { msg = JSON.parse(line); } catch { return; }
+
+  if (msg.method === 'initialize') {
+    respond(msg.id, {
+      protocolVersion: '2024-11-05',
+      capabilities: { tools: { listChanged: false } },
+      serverInfo: { name: 'cortex', version: '1.0.0' },
+    });
+    return;
+  }
+
+  if (msg.method === 'notifications/initialized') return;
+
+  if (msg.method === 'tools/list') {
+    const tools = await fetchJSON('/api/cortex/mcp/tools');
+    respond(msg.id, { tools: tools || [] });
+    return;
+  }
+
+  if (msg.method === 'tools/call') {
+    const { name, arguments: args } = msg.params;
+    const result = await fetchJSON('/api/cortex/mcp/call', {
+      method: 'POST',
+      body: JSON.stringify({ name, args }),
+    });
+    respond(msg.id, result || { content: [{ type: 'text', text: 'Error calling tool' }], isError: true });
+    return;
+  }
+
+  respond(msg.id, null, { code: -32601, message: `Method not found: ${msg.method}` });
+});
+
+function respond(id, result, error) {
+  const msg = { jsonrpc: '2.0', id };
+  if (error) msg.error = error;
+  else msg.result = result;
+  process.stdout.write(JSON.stringify(msg) + '\n');
+}
+
+async function fetchJSON(path, opts = {}) {
+  try {
+    const headers = { 'Content-Type': 'application/json' };
+    if (INTERNAL_TOKEN) headers['x-spaces-internal'] = INTERNAL_TOKEN;
+    const res = await fetch(`${SPACES_URL}${path}`, { ...opts, headers: { ...headers, ...opts.headers } });
+    if (res.ok) return await res.json();
+    return null;
+  } catch { return null; }
+}