IVRZ-da
agentiker-code-intel
70 AST-aware code intelligence tools for Hermes Agent using tree-sitter, ast-grep, and LSP bridge across 9 languages.
Repository last updated Jul 8, 2026
Overview
agentiker-code-intel is a Hermes Agent plugin that provides deep code intelligence by understanding your code's abstract syntax tree (AST), not just its text. It combines three powerful engines: tree-sitter for fast offline parsing, ast-grep for structural search and refactoring, and an LSP bridge for semantic operations like go-to-definition and diagnostics. This gives you editor-grade code analysis directly in the terminal.
The plugin offers 70 tools covering symbol extraction, structural search, safe refactoring, dependency analysis, impact analysis, and more. It supports Python, TypeScript, JavaScript, Go, Rust, Java, C, C++, and TSX. Tools fall back gracefully: LSP-dependent features use AST analysis when no language server is available.
Designed for developers using Hermes Agent, this plugin reduces token usage for code navigation by 10–50× compared to reading raw files. It's ideal for code review, refactoring, dependency management, and automated analysis within agent workflows.
Highlights
- 70 AST-aware tools for symbol extraction, search, and refactoring
- Supports 9 languages: C, C++, Go, Java, JavaScript, Python, Rust, TSX, TypeScript
- LSP bridge for definition, references, diagnostics, and more
- SQLite-persistent import graph for knowledge queries
- Dry-run refactoring with ast-grep for safe bulk changes
- Impact analysis with blast radius and test coverage
Features
Symbol Extraction
Get all functions, classes, and methods with signatures and line numbers without reading the entire file.
Structural Search
Find imports, decorators, function calls, and try/catch blocks by AST node type, not regex.
Safe Refactoring
Rename patterns, wrap functions, and add parameters across files with dry-run by default.
Dependency Analysis
Analyze blast radius, hot paths, dependency risk, and circular imports via Tarjan's SCC algorithm.
LSP Integration
Go-to-definition, find references, diagnostics, hover, completion, and more with AST fallback.
Knowledge Graph
Build a SQLite-persistent import graph for querying callers, callees, and health metrics.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
cd ~/.hermes/plugins
git clone https://github.com/IVRZ-da/agentiker-code-intel.git
cd agentiker-code-intel
pip install -e .# Symbole einer Datei abrufen (ohne die ganze Datei zu lesen)
code_symbols(path="src/service.py")
# Strukturelle Suche — finde alle Imports
code_search(path="src/", preset="imports")
# Go-to-Definition
code_definition(path="src/service.py", line=42)
# Alle Referenzen eines Symbols finden
code_references(path="src/service.py", line=42)
# Code-Risiko-Analyse
code_dependency_risk(path="src/")
code_blast_radius(path="src/service.py", line=42)
# Impact-Analyse vor Refactoring
code_impact(path="src/service.py", line=42)Requirements
- Hermes Agent installed
- Python 3.8+
- tree-sitter>=0.24.0
- ast-grep-py>=0.37.0
- rich>=13.0
- PyYAML>=6.0
How it's built
The plugin is written in Python and organized into several modules. Core AST tools live in code_tools.py and use tree-sitter and ast-grep-py for parsing and structural operations. The LSP bridge is in the lsp/ directory, with a connection pool (lsp/bridge/pool.py), server management (lsp/bridge/server.py), and tool handlers (lsp/tools.py, lsp/tools_core.py, lsp/tools_extra.py). The import graph is built and persisted in _import_graph.py using SQLite.
The plugin is installed as a Python package via pip install -e . and enabled in ~/.hermes/config.yaml. Dependencies include tree-sitter>=0.24.0, ast-grep-py>=0.37.0, rich>=13.0, and PyYAML>=6.0. LSP servers are auto-detected via PATH, node_modules/.bin, or npx fallback. Monorepo support is automatic for pnpm-workspace.yaml, nx.json, and lerna.json.
The plugin provides 70 tools organized into profiles: core (22 tools), search (15), edit (10), lsp (25), and all (70). All tools are automatically available to delegated subagents via delegate_task with the agentiker_code_intel toolset.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The IVRZ-da/agentiker-code-intel repository is the authoritative source and the place to file issues or contribute.
Category: Developer Tools · Licensed under MIT