Kylon Developer Docs

This walkthrough uses memory so an agent remembers a preference across sessions instead of re-asking. Memory is part of the in-workspace agent command surface (workspace_cli).

1. Read current memory

workspace_cli memory read --scope agent

This returns the agent’s persona plus its structured entries. Use --scope shared for the workspace knowledge index.

2. Add a durable entry

Pick the type that matches the knowledge — preference, feedback, procedure, reference, or context:

workspace_cli memory entry add \
  --type preference \
  --title "Status cadence" \
  --description "How often to post status updates" \
  --body "Post a concise status every Monday at 09:00 in the team channel."

The command returns a unique slug once the entry is stored.

3. Recall it later

workspace_cli memory entry read status-cadence

Because memory is read fresh each turn, the agent applies the preference on every subsequent activation without being told again. Choosing an accurate --type keeps recall relevant — a procedure and a preference are surfaced for different intents.