aft: Give Coding Agents IDE-Style Code Tools

Overview

AFT is a Rust-based toolkit that gives supported coding agents structured ways to inspect and change a codebase. Instead of relying only on whole-file reads and line-based edits, agents can navigate symbols, search by meaning, and make parsed, formatted changes.

It also manages supporting work such as background shell tasks, interactive terminal sessions, and compressed command output. AFT is aimed at developers using OpenCode, Pi, or OMP who want these capabilities integrated into their agent workflow.

Key Features

• Symbol outlines and focused inspection of functions, types, and other code structures.
• Hybrid semantic and lexical search over indexed code, with local, OpenAI-compatible, or Ollama embedding backends.
• Symbol-aware edits, multi-file changes, AST-based search and replacement, and language-aware import organization.
• Codebase inspection covering LSP diagnostics, TODOs, metrics, dead code, unused exports, and duplicates.
• Indexed grep and file discovery, with indexes kept current by a file watcher.
• Background shell tasks, PTY sessions, and compressed command output for long-running or noisy work.
• Per-file undo history and checkpoints to help recover from changes.

Use Cases

• OpenCode, Pi, or OMP users can give coding agents structured navigation and editing tools rather than relying on raw file and shell operations alone.
• Developers working in large repositories can locate relevant code by symbol, call relationships, or semantic similarity before making changes.
• Agents performing cross-file refactors can use parsed edits and AST operations to reduce dependence on fragile line locations.
• Teams running tests, installers, or other long shell jobs can let an agent start background work and review concise output later.

Getting Started

Run the setup command to detect and configure installed supported harnesses:

npx @cortexkit/aft@latest setup

See the README for harness options, configuration, and development instructions.

Alternatives

• GitNexus: GitNexus builds an interactive knowledge graph and Graph RAG interface for code exploration, while AFT provides agent-facing navigation, edits, search, and shell tasks.

Considerations

• The setup flow supports OpenCode, Pi, and OMP through the Pi plugin; it is not presented as a general-purpose adapter for every coding-agent harness.
• The core is written in Rust, and building the workspace also requires Bun and a Rust stable toolchain. The README specifies Rust 1.92 or newer for development builds.
• Language capabilities vary. The README distinguishes outline, AST, semantic-search, import, and refactor coverage, and notes specific grammar limitations.
• The README says the reproducible benchmark suite is still in progress, so it does not provide finalized performance or task-success comparisons.
• AFT stores backups, indexes, and downloaded LSP servers under a shared local data directory. Review the documented uninstall steps if removing it, since clearing caches alone does not remove its harness registration or shared storage.