gobby-cli

Rust CLI tools for AI-assisted development.
Code search, symbol navigation, output compression, and local LLM launching — all from the terminal.

---

What's Inside

This workspace contains four Gobby CLI tools plus a shared library:

gcode — Code Search & Navigation

AST-aware code search powered by tree-sitter. Indexes 18 languages into SQLite FTS5 for symbol lookup, content search, file tree navigation, and hybrid ranking. When Neo4j, Qdrant, and an embeddings endpoint are configured - typically through Gobby - gcode adds graph-aware search, semantic search, dependency analysis (callers, usages, imports, blast-radius), and daemon-backed graph lifecycle commands (gcode graph clear, gcode graph rebuild).

gsqz — Output Compression

Squeezes CLI output before it eats your context window. 28 built-in pipelines for git, cargo, pytest, eslint, ruff, npm, and more. Filters noise, groups errors by rule, collapses repeats, and typically reduces token consumption by >90%. ~9ms overhead. YAML-configurable with layered config (global → project → CLI).

gloc — Local LLM Launcher

One command to launch Claude Code or Codex against a local LLM backend. Auto-detects LM Studio and Ollama, manages Ollama model lifecycle (pull, load, warmup), sets the right env vars, and execs into your CLI of choice. YAML-configurable with aliases, per-client env templates, and ordered backend priority.

ghook — Hook Dispatcher

Sandbox-tolerant hook dispatcher invoked by host AI CLIs (Claude Code, Codex, Gemini CLI, Qwen CLI) on lifecycle and tool-use events. Spools envelopes to ~/.gobby/hooks/inbox/ before POSTing to the local Gobby daemon, so the daemon's drain worker can replay any delivery lost to a sandbox FS-read denial, network blip, or daemon restart. You don't usually invoke it directly — Gobby wires it into your AI CLI for you.

gobby-core underpins them all — a small shared-primitives library (project root walk-up, bootstrap config, daemon URL). Not a standalone tool.

Documentation

• gcode User Guide — search, symbols, dependency graphs, project management
• gsqz User Guide — pipelines, step types, configuration, debugging
• gloc User Guide — backends, clients, model management, configuration
• ghook User Guide — hook wiring, diagnose mode, inbox/replay, troubleshooting
• Changelog — release history
• gcode README — architecture and build details
• gsqz README — architecture and build details

Install

Pre-built binaries

Download from GitHub Releases. Binaries are available for macOS (ARM/x86), Linux (x86/ARM), and Windows (x86/ARM).

From crates.io

# gcode
cargo install gobby-code

# gsqz
cargo install gobby-squeeze

# gloc
cargo install gobby-local

# ghook
cargo install gobby-hooks

gcode graph and semantic features are configured at runtime. There are no Cargo feature flags for Neo4j, Qdrant, or embeddings support.

From source

git clone https://github.com/GobbyAI/gobby-cli.git
cd gobby-cli
cargo install --path crates/gcode
cargo install --path crates/gsqz
cargo install --path crates/gloc
cargo install --path crates/ghook

Development

cargo build --workspace --no-default-features   # Build all tools
cargo test --workspace --no-default-features    # Test all tools
cargo clippy --workspace --no-default-features -- -D warnings  # Lint all tools
cargo fmt --all --check                         # Check formatting

License

Apache 2.0 — see LICENSE.