akili graph

Delegate commands to the akili-graph CLI, which manages the platform’s operational knowledge graph. All arguments after akili graph are passed through to the underlying akili-graph binary.

Synopsis

akili graph <args>...

Description

akili graph is a passthrough command that delegates to the akili-graph CLI. The knowledge graph tracks tasks, sessions, errors, lessons, and operational knowledge for the platform. This command provides a unified entry point through the akili CLI.

The akili-graph binary is located using the following detection order:

1. AKILI_GRAPH_PATH environment variable (if set)
2. scripts/akili-graph/akili-graph relative to the repository root
3. akili-graph on the system PATH

Note

akili graph is a local-only command. It does not contact the control plane API and does not require authentication. All operations are performed against the local knowledge graph database.

Examples

# List tasks
akili graph task list --status READY

# Create a new task
akili graph task create --title "Add CDC connector" --milestone M3

# Search knowledge
akili graph knowledge search "retry policy"

# View session history
akili graph session list --limit 10

# View error index
akili graph error list

Common Operations

Task Management

# List tasks by status
akili graph task list --status READY
akili graph task list --status IN_PROGRESS

# Transition a task
akili graph task set TASK-123 --status=DONE

# Create a task
akili graph task create --title "Implement connection rotation" --milestone M5

Knowledge Search

# Search the knowledge base
akili graph knowledge search "Kubernetes networking"

# Add external knowledge
akili graph knowledge add \
  --url "https://kubernetes.io/docs/concepts/services-networking/" \
  --source "Kubernetes docs" \
  --domain "infrastructure" \
  --topic "K8s networking" \
  --summary "Service discovery and DNS resolution in K8s" \
  --ttl 90

Session Management

# Create a session
akili graph session create

# Update a session
akili graph session update SESSION-42 --problems "Fixed DLQ replay ordering"

# List recent sessions
akili graph session list --limit 5

Error Tracking

# Add an error to the index
akili graph error add

# List known errors
akili graph error list

Environment Variables

Variable	Description
AKILI_GRAPH_PATH	Override the path to the akili-graph binary

Exit Codes

The exit code matches whatever the underlying akili-graph binary returns. A non-zero exit from akili-graph causes akili graph to exit with the same code.