solon

solon-cli

Solon v0.5.0 — A Rust CLI tool and workflow engine for precise, hash-validated file editing with semantic code search, language server protocol support, and full development workflow orchestration across 3 plugins (24 skills).

Features

• Hashline Editing — Edit files by line reference with xxHash32 CIDs for validation
• AST-based Search & Replace — Semantic code search via ast-grep integration
• Language Server Protocol (LSP) — Code intelligence (diagnostics, goto-def, hover, references)
• Claude Code Plugins — 3 plugins (solon-cli: 5 skills; solon-core: 11 skills + hooks; solon-skills: 8 domain skills)
• Token Efficiency — Preemptive compaction, per-tool output truncation, semantic compression (20-40% reduction)
• Agent Quality — Intent gate classification, wisdom accumulation, todo enforcement, comment slop detection
• Workflow Engine — Full development workflow: brainstorm → plan → ship → test → review via skill integration

Quick Install

# Clone and build
git clone https://github.com/yourusername/solon.git
cd solon
cargo install --path .

# Verify installation
sl --version

Quick Start

Read Files

# Read entire file
sl read src/main.rs

# Read specific lines
sl read src/main.rs --lines 10:20

# Read in chunks (useful for large files)
sl read data.json --chunk-size 50

Edit Files

# Edit by line hash reference
sl edit src/main.rs 5#MQ 10#HW "fn new_function() {}"

# Append content after a line
sl edit src/main.rs 15#AQ "" "println!(\"new line\");" --after

# Delete lines
sl edit src/main.rs 20#XY 25#ZZ --delete

# Read from stdin
echo "new code" | sl edit src/main.rs 5#MQ --stdin

Search & Replace (AST-based)

# Search for functions in Rust
sl ast search "fn \$NAME(\$\$\$ARGS)" --lang rust

# Search in specific directory
sl ast search "function \$NAME()" --lang typescript --path src/

# Replace (preview only)
sl ast replace "fn main() {}" "fn main() -> Result<()> {}" --lang rust

Language Server Features

# Get diagnostics
sl lsp diagnostics src/main.rs

# Goto definition
sl lsp goto-def src/main.rs 25 10

# Find references
sl lsp references src/main.rs 15 5

# Hover information
sl lsp hover src/main.rs 20 0

Workflow Commands

# Plan management (via hooks)
sl plan resolve

# Task management (via hooks)
sl task hydrate plans/YYMMDD-my-feature

# Workflow status (via hooks)
sl workflow status plans/YYMMDD-my-feature

Documentation

Full documentation is available in /docs:

• User Guide — Detailed CLI usage and examples
• API Reference — Command reference and options
• System Architecture — Internal design and subsystems
• FAQ & Troubleshooting — Common issues and solutions
• Code Standards — Development guidelines

Architecture

Solon is a Cargo workspace with a unified Rust binary and 3 Claude Code plugins:

• Binary (sl): Rust command-line tool with 4 subsystems:

  1. Hashline — Line-ID editing with content validation via xxHash32
  2. AST-grep — Semantic search/replace for code (requires sg binary)
  3. LSP Client — Language server protocol integration (stdio JSON-RPC)
  4. Workspace — 3 crates (solon-common, solon-cli, solon-core)

• Plugins: Three Claude Code plugins registered in marketplace

  1. solon-cli (5 skills): hashline-read, hashline-edit, ast-search, ast-replace, lsp-tools
  2. solon-core (11 skills + hooks): workflow skills (brainstorm, plan, docs, fix, ask, bootstrap, review, release, ship, watzup, test) + hooks system
  3. solon-skills (8 domain skills): sequential-thinking, git, frontend-development, backend-development, databases, devops, docs-seeker, ai-multimodal

Requirements

• Rust 1.70+
• For AST features: sg binary (auto-downloaded on first use)
• For LSP features: Appropriate language server installed (rust-analyzer, typescript-language-server, etc.)

License

Licensed under the Apache License, Version 2.0. See LICENSE file for details.

Support

For issues, questions, or feature requests, please check FAQ & Troubleshooting or open an issue on GitHub.