https://github.com/gobbyai/gobby-cli
Rust CLI tools for AI-assisted development. AST-aware code search with tree-sitter + FTS5, and a YAML-configurable output compressor with 28 built-in pipelines. >90% token savings. Part of Gobby, works standalone.
https://github.com/gobbyai/gobby-cli
ai-agents ai-coding-assistant ai-pair-programming ast claude-code cli code-search dependency-graph developer-tools fts5 gobby llm neo4j output-compaction rust sqlite symbol-navigation token-optimization tree-sitter yaml
Last synced: 7 days ago
JSON representation
Rust CLI tools for AI-assisted development. AST-aware code search with tree-sitter + FTS5, and a YAML-configurable output compressor with 28 built-in pipelines. >90% token savings. Part of Gobby, works standalone.
- Host: GitHub
- URL: https://github.com/gobbyai/gobby-cli
- Owner: GobbyAI
- License: apache-2.0
- Created: 2026-03-29T18:56:41.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2026-04-03T23:45:54.000Z (23 days ago)
- Last Synced: 2026-04-04T23:18:39.784Z (22 days ago)
- Topics: ai-agents, ai-coding-assistant, ai-pair-programming, ast, claude-code, cli, code-search, dependency-graph, developer-tools, fts5, gobby, llm, neo4j, output-compaction, rust, sqlite, symbol-navigation, token-optimization, tree-sitter, yaml
- Language: Rust
- Size: 479 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
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,
and dependency analysis (`callers`, `usages`, `imports`, `blast-radius`).
### 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 `exec`s 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](docs/guides/gcode-user-guide.md) — search, symbols, dependency graphs, project management
- [gsqz User Guide](docs/guides/gsqz-user-guide.md) — pipelines, step types, configuration, debugging
- [gloc User Guide](docs/guides/gloc-user-guide.md) — backends, clients, model management, configuration
- [ghook User Guide](docs/guides/ghook-user-guide.md) — hook wiring, diagnose mode, inbox/replay, troubleshooting
- [Changelog](CHANGELOG.md) — release history
- [gcode README](crates/gcode/README.md) — architecture and build details
- [gsqz README](crates/gsqz/README.md) — architecture and build details
## Install
### Pre-built binaries
Download from [GitHub Releases](https://github.com/GobbyAI/gobby-cli/releases/latest). Binaries are available for macOS (ARM/x86), Linux (x86/ARM), and Windows (x86/ARM).
### From crates.io
```bash
# 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
```bash
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
```bash
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](LICENSE).