AIHelper

AIHelper is a Rust CLI toolbox for AI agents and developers. It reduces context usage and repetitive shell boilerplate by providing explicit, fast, scriptable commands with predictable text and JSON output.

The binary command is ah.

Status

• Project is in bootstrap stage.
• Plugin-oriented runtime architecture is in place.
• Built-in domains are implemented as plugins:
• file (read, head, tail, stat, tree)
• search (text, files)
• ctx (pack, symbols, changed)
• git (status, tags, remotes, changed, diff, blame)
• project (detect, commands)
• run (check)
• task (save, list, run)
• Plugin management commands are available: ah plugins list|enable|disable|reset.
• MCP stdio server is available through ah mcp serve; every enabled typed command is exposed as a separate ah.* tool with schemas and risk metadata.
• External dynamic plugin sources are included: plugins/ah-plugin-github, plugins/ah-plugin-gitlab, plugins/ah-plugin-ollama, plugins/ah-plugin-postgres.

Quick Start

cargo build
cargo run --bin ah -- --help
cargo run --bin ah -- plugins list
cargo run --bin ah -- file read README.md -n --from 1 --to 40
cargo run --bin ah -- --cwd . mcp serve

Runtime Layout

• ah (or ah.exe) in root directory
• dynamic plugins in plugins/ next to executable:
  • plugins/ah-plugin-<name>.dll (Windows)
  • plugins/ah-plugin-<name>.so (Linux)
  • plugins/ah-plugin-<name>.dylib (macOS)

Project Layout

• src/ application source code
• src/commands/ CLI domains (file, search, ctx, git, project, run, task)
• tests/ integration and smoke tests
• docs/agents/ token-efficient recipes for AI agents
• docs/developers/ architecture and contribution docs
• docs/reference/ command reference

Documentation

• Agents guide
• Developer guide
• Command reference
• MCP stdio reference
• Changelog