Skip to main content
Display all adist projects with their status, paths, and metadata.

​
Syntax

adist list [options]

​
Options

​
-d, --debug
boolean
Show debug information including number of indexed files per project.

​
Output Format

For each project, displays:
  • Current indicator: → for active project
  • Project name (bold)
  • Status indicators:
    • [indexed] or [not-indexed] - Index status
    • [summaries] or [no-summaries] - Summary availability
  • Project ID - Unique identifier
  • Path - Full filesystem path

​
With Debug Flag

Additionally shows:
  • Number of indexed files

​
Examples

​
Basic list

adist list
Output: 
Projects:

→ my-project [indexed] [summaries]
  ID: 1234567890
  Path: /home/user/projects/my-project

  another-project [indexed] [no-summaries]
  ID: 1234567891
  Path: /home/user/projects/another-project

  old-project [not-indexed] [no-summaries]
  ID: 1234567892
  Path: /home/user/projects/old-project

​
List with debug info

adist list --debug
Additional output per project: 
  Indexed files: 42

​
Status Indicators

​
indexed
status
Green: Project has been indexed and is searchableRed (not-indexed): Project needs indexing via adist reindex
​
summaries
status
Green: Project has AI-generated summariesRed (no-summaries): Run adist reindex --summarize to generate

​
Current Project

The current project is indicated by a green arrow (→) and is the default target for:
  • Search commands (adist get, adist query)
  • Chat sessions (adist chat)
  • Reindexing without project name (adist reindex)
  • Summary views (adist summary)

​
Empty State

If no projects exist: 
No projects found. Use "adist init <projectName>" to create one.

​
Use Cases

  • Check which project is currently active
  • Verify project index and summary status
  • Get project IDs for troubleshooting
  • Review all managed projects at a glance

Build docs developers (and LLMs) love

Get started for freeTalk to us