| title | Graxus | |||
|---|---|---|---|---|
| type | project | |||
| status | active | |||
| tags |
|
AI-native codebase knowledge engine for AI agents.
Graxus builds a documentation graph for Markdown files and a codemap for source code, then exposes search, safe editing, semantic relationships, and bounded agent context through a CLI/API.
- Docs Graph — Obsidian-compatible Markdown knowledge graph
- Code Codemap — Ripex v0.3.0-first source analysis with a per-file tree-sitter fallback
- Semantic facts — HTTP routes, type relationships, and dependency-injection bindings
- Search and edit — Literal, regex, symbol search, previewed replacements, and snapshot rollback
- Agent API — Query-aware context and deterministic, token-bounded exports
graxus init
graxus index --codemap-backend ripex # ripex is the default
graxus status
graxus find "auth"
graxus update --dry-run # inspect an incremental updateUse graxus update to re-index added or modified files, remove deleted-file data, refresh cross-file relationships, and replace the touched rows in SQLite. Use graxus index for a full rebuild.
Ripex is the primary parser dependency (ripex = 0.3.0) for:
- JavaScript and TypeScript
- Python
- Go
- Rust
- C and C++
- C#
Graxus records the requested and actual backend per file. If Ripex does not support a language or cannot extract a file, Graxus falls back to tree-sitter for that file; Java, Kotlin, and Swift therefore remain available through the fallback path.
Implemented route extraction covers FastAPI, Flask, and Django (Python); Axum, Actix Web, and Rocket (Rust); Gin, Fiber, and Echo (Go); Express, NestJS, and Next.js app-router (JavaScript/TypeScript); ASP.NET Core minimal APIs and controller attributes (C#); and Crow, Pistache, and Drogon (C++).
Express and Next.js route facts preserve whether the source file is JavaScript or TypeScript. NestJS dependency-injection facts preserve JavaScript or TypeScript language and include @Injectable and useClass providers. Type relationships include C# class, record, struct, and interface base/interface lists.
Context queries honor a token budget and CLI caps for files, symbols, notes, depth, confidence, and edges. graxus agent-export --budget N uses deterministic category budgets (including routes, type relationships, DI bindings, parser provenance, and documentation) and never splits an individual fact.
See the CLI guide for commands and options.
Useful semantic commands:
graxus routes --json
graxus routes --framework express --lang javascript
graxus types --json
graxus context --query "auth" --budget 12000
graxus agent-export --budget 12000- Architecture
- Codemap and parser pipeline
- Route facts
- Type and DI resolution
- Agent context
- Safety model
Graxus consumes the published Ripex v0.3.0 release as its primary parser. See the Ripex repository for the parser's source and release history.