How npci/ainxt-cli works
AiNxt CLI is a terminal-based AI coding agent. Its principal loop takes a user instruction, consults model and repository context, proposes tool actions, gates consequential actions through permissions, then presents results in the terminal. The repository also contains substantial codebase indexing, session/authentication, memory, voice, and worktree capabilities. The excerpts establish only a few internal calls; other workflow links are shown as unverified rather than inferred from module names. The README excerpt documents the product loop but does not expose a repository file path for citation.
Main entry points: agent.rs Agent runtime · main.rs Interactive CLI · context.rs Tool runtime · manager.rs Permission decisions
Components 19
Terminal experience
- Interactive CLI
crates/codegen/ainxt-pager-bin/src/main.rs - Terminal rendering
crates/codegen/ainxt-pager-render/src/render/draw.rs - Voice input
crates/codegen/ainxt-voice/src/pipeline.rs
Agent capabilities
- Agent runtime
crates/codegen/ainxt-agent/src/agent.rs - Prompt assembly
crates/codegen/ainxt-agent/src/prompt/context.rs - Tool runtime
crates/common/ainxt-tool-runtime/src/context.rs - Model provider
Governance and sessions
- Permission decisions
crates/codegen/ainxt-workspace/src/permission/manager.rs - Security policy
crates/common/ainxt-policy/src/engine.rs - Authentication
crates/codegen/ainxt-shell/src/auth/flow.rs - Credential storage
crates/codegen/ainxt-shell/src/auth/storage.rs - Session state
crates/codegen/ainxt-chat-state/src/actor/state.rs - Session feedback
crates/codegen/ainxt-shell/src/session/feedback_manager.rs - Feedback service client
crates/codegen/ainxt-shell/src/agent/feedback_client.rs
Repository and state
- Codebase index
crates/codegen/ainxt-codebase-graph/src/index_manager.rs - Scope graph
crates/codegen/ainxt-codebase-graph/src/scope_graph/graph.rs - Persistent memory
crates/codegen/ainxt-memory/src/storage.rs - Fast worktrees
crates/codegen/ainxt-fast-worktree/src/copy/engine.rs
Other components
- User
Connections 17
- User → Interactive CLI: enters request
- Interactive CLI → Agent runtime: starts agent
- Agent runtime → Prompt assembly: assembles context
- Agent runtime → Model provider: requests completion
- Agent runtime → Tool runtime: dispatches tools
- Tool runtime → Permission decisions: requests authorization
- Permission decisions → Security policy: consults policy
- Interactive CLI → Terminal rendering: renders interface
- Interactive CLI → Authentication: ensures identity
- Authentication → Credential storage: reads credentials
crates/codegen/ainxt-shell/src/auth/storage.rs - Interactive CLI → Session state: manages conversation
- Session feedback → Feedback service client: syncs signals
crates/codegen/ainxt-shell/src/session/feedback_manager.rs - Codebase index → Scope graph: updates graph
- Agent runtime → Codebase index: queries repository
- Agent runtime → Persistent memory: uses memory
- Agent runtime → Fast worktrees: creates worktree
- Voice input → Interactive CLI: emits voice events