README
¶
Code Navigation
human codenav indexes a repository into a local SQLite database and answers structural questions about it — go-to-definition, find-references, call graphs, blast radius, and full-text search — fast, offline, and token-frugal, so an AI agent can navigate code without dumping whole files into context. It runs locally where the code is and is never forwarded to the daemon.
- Indexes Go precisely and other languages structurally
- Go-to-definition and find-references with exact locations
- Walks call graphs: callers, callees, and call paths
- Reports blast radius of a symbol or a git diff
- Full-text search over code bodies and symbol names
- Lists detected web routes and their handlers
- Keeps one local index for many repositories
Documentation
¶
Overview ¶
Package codenav holds shared helpers for the code-navigation feature, whose engine lives in the store, query, graph, and index subpackages.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DefaultDBPath ¶
func DefaultDBPath() string
DefaultDBPath returns the path to the code-navigation index database under ~/.human/, creating the directory if needed and falling back to ./.human/ when the home directory is unknown. Mirrors the convention used by internal/index and internal/stats.
Types ¶
This section is empty.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package graph answers reachability questions over the CALLS edge table using depth-capped, cycle-guarded recursive CTEs.
|
Package graph answers reachability questions over the CALLS edge table using depth-capped, cycle-guarded recursive CTEs. |
|
Package index defines the indexing contract and the data types that flow from a language backend into the store.
|
Package index defines the indexing contract and the data types that flow from a language backend into the store. |
|
Package query is the single source of truth for codenav's read operations: search, definition, references, callers, callees and call-path.
|
Package query is the single source of truth for codenav's read operations: search, definition, references, callers, callees and call-path. |
|
Package store owns the SQLite database: connection, schema migration, project lifecycle, and a Writer that persists what indexers extract.
|
Package store owns the SQLite database: connection, schema migration, project lifecycle, and a Writer that persists what indexers extract. |