Uteke CLI Guide: Every Command You Need to Know
Complete reference for Uteke CLI — remember, recall, search, rooms, tags, consolidation, aging, export. Every command with examples.
Uteke CLI Guide: Every Command You Need to Know
Uteke ships with a full-featured command-line interface for interacting with your memory store without writing code. Whether you are debugging, scripting, or just exploring, the CLI covers every API endpoint.
Installation
Install via Homebrew on macOS or download the binary from GitHub Releases for Linux. The CLI is the same binary as the server — it detects whether you want to run the server or use CLI mode based on the arguments.
macOS: brew install codecoradev/tap/utekeLinux: download from GitHub Releases, chmod +x, and add to PATH
Server Mode
Start the memory server with the default settings. The server listens on localhost:8767 and loads any existing database from the default data directory. Point your --data-dir flag to a persistent location for production use.
Core Commands
The CLI provides direct access to every API operation. Each command maps to a single REST endpoint.
- remember: store a new memory with optional tags and type
- recall: retrieve memories by semantic search
- search: keyword-based search across all memories
- list: enumerate memories with pagination
- forget: delete a specific memory by ID
- stats: show memory count, index size, and performance metrics
Tags and Filtering
Tags let you organize memories by domain, project, or agent. When recalling, you can filter by tag to narrow results. This is particularly useful when multiple agents share the same Uteke instance.
Use tags like 'project:uteke', 'type:decision', or 'agent:researcher' to create queryable partitions without the overhead of separate rooms.
Room Commands
Rooms provide isolated namespaces within a single Uteke instance. Room-specific commands let you create, list, and interact with room-scoped memories.
- room create: create a new room with a name
- room list: show all rooms
- room remember: add a memory to a specific room
- room recall: search within a room
- room summary: get a condensed overview of room contents
Scripting with the CLI
The CLI outputs structured JSON by default, making it easy to pipe into jq or capture in scripts. Combine with xargs or parallel for bulk operations like importing a directory of documents.
Full CLI reference is in the Uteke README.