Skip to main content
Start an interactive, multi-turn chat session with AI about your project. Maintains conversation history and context across messages.

Syntax

adist chat [options]

Options

--stream
boolean
Enable streaming responses for real-time output.Note: Code highlighting may not work properly in streaming mode.

Slash Commands

Within the chat session, use these commands:
/help
command
Display available slash commands.
/exit
command
Exit the chat session.
/reset
command
Clear chat history and start fresh.
/clear
command
Clear the terminal screen.
/cost
command
Show total session cost.
/debug
command
Toggle debug information display.
/reindex
command
Reindex the project with summaries without exiting chat.

Behavior

  • Maintains conversation history across all messages
  • Searches for relevant code blocks for each question
  • Uses project summaries when available
  • Shows document tree for each query in debug mode
  • Tracks cumulative API costs
  • Supports tab completion for slash commands

Examples

Start a chat session

adist chat

Start with streaming enabled

adist chat --stream

Example conversation

adist chat

You: How does the authentication system work?
# AI provides answer...

You: Can you show me the login function?
# AI provides specific code example...

You: /cost
# Shows: Total session cost: $0.0234

You: /exit

Session Information

Each response displays:
  • Debug Info: Relevant documents and blocks found (if debug enabled)
  • Document Tree: Visual representation of matched files
  • Answer: AI response with code highlighting
  • Message Cost: Cost for individual message
  • Context Status: Cache usage indicator
  • Query Complexity: Complexity rating

Context Management

  • Conversation history is maintained in memory
  • Context is automatically included in follow-up questions
  • Use /reset to clear history and reduce costs
  • Project context is cached to minimize API costs

Requirements

  • Active project with indexed files
  • Configured LLM provider
  • Project preferably has summaries for better context

Warnings

On startup, you’ll be notified if:
  • Project has no indexed files
  • Project lacks block-based indexes
  • Project doesn’t have summaries

Environment Variables

ANTHROPIC_API_KEY
string
Required if using Anthropic Claude provider.
OPENAI_API_KEY
string
Required if using OpenAI provider.

Build docs developers (and LLMs) love