# npci/ainxt-cli architecture

> Architecture diagram of the GitHub repository npci/ainxt-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/npci/ainxt-cli
- Repository: https://github.com/npci/ainxt-cli

## Overview

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: [`crates/codegen/ainxt-agent/src/agent.rs`](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-agent/src/agent.rs) (Agent runtime), [`crates/codegen/ainxt-pager-bin/src/main.rs`](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-pager-bin/src/main.rs) (Interactive CLI), [`crates/common/ainxt-tool-runtime/src/context.rs`](https://github.com/npci/ainxt-cli/blob/main/crates/common/ainxt-tool-runtime/src/context.rs) (Tool runtime), [`crates/codegen/ainxt-workspace/src/permission/manager.rs`](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-workspace/src/permission/manager.rs) (Permission decisions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_terminal["Terminal experience"]
  node_tui["Interactive CLI<br/>[main.rs]"]
  node_render["Terminal rendering<br/>[draw.rs]"]
  node_voice["Voice input<br/>[pipeline.rs]"]
end

subgraph group_agent["Agent capabilities"]
  node_agent_loop["Agent runtime<br/>[agent.rs]"]
  node_prompt["Prompt assembly<br/>[context.rs]"]
  node_tools["Tool runtime<br/>[context.rs]"]
  node_model{{"Model provider"}}
end

subgraph group_governance["Governance and sessions"]
  node_permissions["Permission decisions<br/>[manager.rs]"]
  node_policy["Security policy<br/>[engine.rs]"]
  node_auth["Authentication<br/>[flow.rs]"]
  node_auth_store[("Credential storage<br/>[storage.rs]")]
  node_session["Session state<br/>[state.rs]"]
  node_feedback["Session feedback"]
  node_feedback_api["Feedback service client<br/>[feedback_client.rs]"]
end

subgraph group_support["Repository and state"]
  node_code_index[("Codebase index<br/>[index_manager.rs]")]
  node_scope_graph["Scope graph<br/>[graph.rs]"]
  node_memory[("Persistent memory<br/>[storage.rs]")]
  node_worktree["Fast worktrees<br/>[engine.rs]"]
end

node_user(("User"))

node_user -.->|"enters request"| node_tui
node_tui -.->|"starts agent"| node_agent_loop
node_agent_loop -.->|"assembles context"| node_prompt
node_agent_loop -.->|"requests completion"| node_model
node_agent_loop -.->|"dispatches tools"| node_tools
node_tools -.->|"requests authorization"| node_permissions
node_permissions -.->|"consults policy"| node_policy
node_tui -.->|"renders interface"| node_render
node_tui -.->|"ensures identity"| node_auth
node_auth -->|"reads credentials"| node_auth_store
node_tui -.->|"manages conversation"| node_session
node_feedback -->|"syncs signals"| node_feedback_api
node_code_index -.->|"updates graph"| node_scope_graph
node_agent_loop -.->|"queries repository"| node_code_index
node_agent_loop -.->|"uses memory"| node_memory
node_agent_loop -.->|"creates worktree"| node_worktree
node_voice -.->|"emits voice events"| node_tui

click node_tui "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-pager-bin/src/main.rs"
click node_render "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-pager-render/src/render/draw.rs"
click node_agent_loop "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-agent/src/agent.rs"
click node_prompt "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-agent/src/prompt/context.rs"
click node_tools "https://github.com/npci/ainxt-cli/blob/main/crates/common/ainxt-tool-runtime/src/context.rs"
click node_permissions "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-workspace/src/permission/manager.rs"
click node_policy "https://github.com/npci/ainxt-cli/blob/main/crates/common/ainxt-policy/src/engine.rs"
click node_auth "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/auth/flow.rs"
click node_auth_store "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/auth/storage.rs"
click node_session "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-chat-state/src/actor/state.rs"
click node_feedback "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/session/feedback_manager.rs"
click node_feedback_api "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/agent/feedback_client.rs"
click node_code_index "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-codebase-graph/src/index_manager.rs"
click node_scope_graph "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-codebase-graph/src/scope_graph/graph.rs"
click node_memory "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-memory/src/storage.rs"
click node_worktree "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-fast-worktree/src/copy/engine.rs"
click node_voice "https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-voice/src/pipeline.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tui,node_render,node_voice,node_user toneBlue
class node_agent_loop,node_prompt,node_tools,node_model toneAmber
class node_permissions,node_policy,node_auth,node_auth_store,node_session,node_feedback,node_feedback_api toneMint
class node_code_index,node_scope_graph,node_memory,node_worktree toneRose
```

## Components

### Terminal experience

- [Interactive CLI](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-pager-bin/src/main.rs): `crates/codegen/ainxt-pager-bin/src/main.rs`
- [Terminal rendering](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-pager-render/src/render/draw.rs): `crates/codegen/ainxt-pager-render/src/render/draw.rs`
- [Voice input](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-voice/src/pipeline.rs): `crates/codegen/ainxt-voice/src/pipeline.rs`

### Agent capabilities

- [Agent runtime](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-agent/src/agent.rs): `crates/codegen/ainxt-agent/src/agent.rs`
- [Prompt assembly](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-agent/src/prompt/context.rs): `crates/codegen/ainxt-agent/src/prompt/context.rs`
- [Tool runtime](https://github.com/npci/ainxt-cli/blob/main/crates/common/ainxt-tool-runtime/src/context.rs): `crates/common/ainxt-tool-runtime/src/context.rs`
- **Model provider**

### Governance and sessions

- [Permission decisions](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-workspace/src/permission/manager.rs): `crates/codegen/ainxt-workspace/src/permission/manager.rs`
- [Security policy](https://github.com/npci/ainxt-cli/blob/main/crates/common/ainxt-policy/src/engine.rs): `crates/common/ainxt-policy/src/engine.rs`
- [Authentication](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/auth/flow.rs): `crates/codegen/ainxt-shell/src/auth/flow.rs`
- [Credential storage](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/auth/storage.rs): `crates/codegen/ainxt-shell/src/auth/storage.rs`
- [Session state](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-chat-state/src/actor/state.rs): `crates/codegen/ainxt-chat-state/src/actor/state.rs`
- [Session feedback](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/session/feedback_manager.rs): `crates/codegen/ainxt-shell/src/session/feedback_manager.rs`
- [Feedback service client](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-shell/src/agent/feedback_client.rs): `crates/codegen/ainxt-shell/src/agent/feedback_client.rs`

### Repository and state

- [Codebase index](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-codebase-graph/src/index_manager.rs): `crates/codegen/ainxt-codebase-graph/src/index_manager.rs`
- [Scope graph](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-codebase-graph/src/scope_graph/graph.rs): `crates/codegen/ainxt-codebase-graph/src/scope_graph/graph.rs`
- [Persistent memory](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-memory/src/storage.rs): `crates/codegen/ainxt-memory/src/storage.rs`
- [Fast worktrees](https://github.com/npci/ainxt-cli/blob/main/crates/codegen/ainxt-fast-worktree/src/copy/engine.rs): `crates/codegen/ainxt-fast-worktree/src/copy/engine.rs`

### Other components

- **User**

## Connections

- 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 (evidence: `crates/codegen/ainxt-shell/src/auth/storage.rs`)
- Interactive CLI → Session state: manages conversation
- Session feedback → Feedback service client: syncs signals (evidence: `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
