Agent & Memory¶

Commands for inspecting agent configuration, managing observational memory, and interacting with the knowledge graph store.

Agent Commands¶

lango agent status¶

Show the current agent mode and configuration.

lango agent status [--json]

Flag	Type	Default	Description
`--json`	bool	`false`	Output as JSON

Example:

$ lango agent status
Agent Status
  Mode:         single
  Provider:     anthropic
  Model:        claude-sonnet-4-20250514
  Multi-Agent:  false
  A2A Enabled:  false

When multi-agent mode is enabled:

$ lango agent status
Agent Status
  Mode:         multi-agent
  Provider:     anthropic
  Model:        claude-sonnet-4-20250514
  Multi-Agent:  true
  A2A Enabled:  true
  A2A Base URL: http://localhost:18789
  A2A Agent:    lango

lango agent list¶

List all available sub-agents (local) and remote A2A agents.

lango agent list [--json] [--check]

Flag	Type	Default	Description
`--json`	bool	`false`	Output as JSON
`--check`	bool	`false`	Test connectivity to remote agents

Local agents are always listed regardless of multi-agent configuration:

Agent	Description
executor	Executes tools including shell commands, file operations, browser automation
researcher	Searches knowledge bases, performs RAG retrieval, graph traversal
planner	Decomposes complex tasks into steps and designs execution plans
memory-manager	Manages conversational memory including observations, reflections

Example:

$ lango agent list
NAME              TYPE   DESCRIPTION
executor          local  Executes tools including shell commands, file operations, browser automation
researcher        local  Searches knowledge bases, performs RAG retrieval, graph traversal
planner           local  Decomposes complex tasks into steps and designs execution plans
memory-manager    local  Manages conversational memory including observations, reflections

NAME              TYPE    URL                                    STATUS
weather-agent     remote  http://weather-svc:8080/.well-known/agent.json  ok

Use --check to verify remote agent connectivity:

$ lango agent list --check
# Remote agents will show "ok", "unreachable", or HTTP status codes

Memory Commands¶

Manage observational memory entries. Memory commands require a --session flag to scope operations to a specific session.

lango memory list¶

List observations and reflections for a session.

lango memory list --session <key> [--type <type>] [--json]

Flag	Type	Default	Description
`--session`	string	required	Session key to query
`--type`	string	(all)	Filter by type: `observations` or `reflections`
`--json`	bool	`false`	Output as JSON

Example:

$ lango memory list --session user-123
ID        TYPE          TOKENS  CREATED           CONTENT
a1b2c3d4  observation   45      2026-02-20 14:30  User prefers concise answers and dislikes...
e5f6g7h8  reflection    120     2026-02-20 14:35  The user has shown a consistent pattern of...

lango memory status¶

Show observational memory status and configuration for a session.

lango memory status --session <key> [--json]

Flag	Type	Default	Description
`--session`	string	required	Session key to query
`--json`	bool	`false`	Output as JSON

Example:

$ lango memory status --session user-123
Observational Memory Status (session: user-123)
  Enabled:                      true
  Provider:                     anthropic
  Model:                        claude-haiku-4-5-20251001
  Observations:                 12 (540 tokens)
  Reflections:                  3 (360 tokens)
  Message Token Threshold:      1000
  Observation Token Threshold:  2000
  Max Message Token Budget:     8000

lango memory clear¶

Clear all observations and reflections for a session. Prompts for confirmation unless --force is specified.

lango memory clear <session-key> [--force]

Argument	Required	Description
`session-key`	Yes	Session key to clear

Flag	Type	Default	Description
`--force`	bool	`false`	Skip confirmation prompt

Example:

$ lango memory clear user-123
This will delete all observations and reflections for session 'user-123'.
Continue? [y/N] y
Cleared all memory entries for session 'user-123'.

Warning

This operation is irreversible. All observations and reflections for the session will be permanently deleted.

Graph Commands¶

Manage the knowledge graph store. The graph must be enabled in configuration (graph.enabled = true).

lango graph status¶

Show knowledge graph status and basic information.

lango graph status [--json]

Flag	Type	Default	Description
`--json`	bool	`false`	Output as JSON

Example:

$ lango graph status
Knowledge Graph Status
  Enabled:       true
  Backend:       bolt
  Database Path: /home/user/.lango/graph.db
  Triples:       1523

When the graph is disabled:

$ lango graph status
Knowledge Graph Status
  Enabled:  false

lango graph query¶

Query triples from the knowledge graph by subject, predicate, and/or object.

lango graph query [--subject <s>] [--predicate <p>] [--object <o>] [--limit N] [--json]

Flag	Type	Default	Description
`--subject`	string		Filter by subject
`--predicate`	string		Filter by predicate (requires `--subject`)
`--object`	string		Filter by object
`--limit`	int	`0`	Limit number of results (0 = unlimited)
`--json`	bool	`false`	Output as JSON

Query Requirements

At least one of --subject or --object is required. The --predicate flag can only be used together with --subject.

Examples:

# Query by subject
$ lango graph query --subject "Go"
SUBJECT  PREDICATE    OBJECT
Go       is_a         programming_language
Go       created_by   Google
Go       has_feature  goroutines

# Query by subject and predicate
$ lango graph query --subject "Go" --predicate "has_feature"
SUBJECT  PREDICATE    OBJECT
Go       has_feature  goroutines
Go       has_feature  channels
Go       has_feature  garbage_collection

# Query by object
$ lango graph query --object "Google" --limit 5

# JSON output
$ lango graph query --subject "Go" --json

lango graph stats¶

Show knowledge graph statistics including total triple count and predicate distribution.

lango graph stats [--json]

Flag	Type	Default	Description
`--json`	bool	`false`	Output as JSON

Example:

$ lango graph stats
Knowledge Graph Statistics
  Total Triples: 1523

PREDICATE       COUNT
is_a            423
has_feature     312
related_to      289
created_by      156

lango graph clear¶

Clear all triples from the knowledge graph. Prompts for confirmation unless --force is specified.

lango graph clear [--force]

Flag	Type	Default	Description
`--force`	bool	`false`	Skip confirmation prompt

Example:

$ lango graph clear
This will delete all triples from the knowledge graph.
Continue? [y/N] y
Cleared all triples from the knowledge graph.

Danger

This operation is irreversible. All graph data will be permanently deleted.