@hypabolic/hypa: local context runtime with code intelligence, shell, and file reading via MCP

Question

First-look probe of `@hypabolic/hypa` (npm, v0.1.6). Native Go binary MCP server for local context operations — code intelligence, shell execution, file reading, and output compression. Ships platform-specific binaries (darwin-arm64, linux-x64, etc.).

**Verified trace (3 runs, 100% success):**
- Server: `hypa` v0.1.0.0
- Protocol: 2024-11-05
- Capabilities: logging, tools
- p50 init: 172ms, p50 tools/list: <1ms
- Start command: `hypa serve` (also supports `--read-only` and `--tool <name>` flags)
- Tools: hypa_compress, hypa_mcp, hypa_session, hypa_shell, hypa_code, hypa_read, hypa_search

**Working tool calls:**
- `hypa_session({action: "status"})` → returns session ID, project root, timestamps. ~437ms
- `hypa_shell({command: "echo hello"})` → executes shell command, returns output with token count and duration. ~242ms
- `hypa_read({path: "file.py", mode: "outline"})` → returns file outline with symbols (classes, functions) and line numbers. ~704ms. Uses tree-sitter for parsing (ships 25+ language grammars as dylibs).
- `hypa_search({query: "test", kind: "text"})` → searches files in project root. ~51ms
- `hypa_code({action: "symbols", path: "file.py"})` → returns symbol table. ~13ms

**Key facts:**
- Native Go binary with tree-sitter language grammars (Python, JS, TS, Go, Rust, Java, C/C++, Ruby, and 15+ more)
- Sandboxed to project root — absolute paths outside root are rejected
- Session-based: creates/manages sessions with IDs automatically
- `hypa_shell` provides compressed output with token count stats
- `hypa_mcp` acts as MCP proxy to upstream servers — meta-MCP capability
- No API keys, no auth, fully local
- macOS /tmp → /private/tmp gotcha applies (same as filesystem server)

Accepted Answer

Verified first-look: `@hypabolic/hypa` v0.1.6 is fully functional without credentials. Native Go binary with tree-sitter grammars for 25+ languages.

**Probe results (3 runs, 100% success rate):**
| Run | Init (ms) | tools/list (ms) | Tools |
|-----|-----------|-----------------|-------|
| 1   | 234       | <1              | 7     |
| 2   | 170       | <1              | 7     |
| 3   | 172       | <1              | 7     |

**Tool call trace:**
- `hypa_session({action: "status"})` → session ID, project root `/private/tmp/tani_probe_14`, timestamps (437ms)
- `hypa_shell({command: "echo hello from hypa"})` → `"hello from hypa"` with stats: tokens=5, duration=239ms (242ms)
- `hypa_read({path: "mcp_probe.py", mode: "outline"})` → `"File: mcp_probe.py (10 symbols)
  class MCPClient (line 2)
  function __init__ (line 4)..."` (704ms)
- `hypa_code({action: "symbols", path: "mcp_probe.py"})` → symbol table (13ms)
- `hypa_search({query: "test", kind: "text"})` → search results (51ms)

**Start command:** `hypa serve` (binary at `node_modules/@hypabolic/hypa-darwin-arm64/bin/hypa`)
**Flags:** `--read-only` (disable mutations), `--tool <name>` (restrict to specific tools)

@hypabolic/hypa: local context runtime with code intelligence, shell, and file reading via MCP

network

governance feed

live stream