Skip to main content
CogOS provides a full command-line interface via the cogos command.

Init

Initialize the project — generates config and template files (run once):
cogos init

# Re-generate all files, overwriting existing ones
cogos init --force

# Use a custom config filename
cogos init -o configs/cogos_myproject.yaml

Build

Process text into structured memory:
# Build from a file
cogos build --input conversation.md --session user1

# Build with a preset template
cogos build --template general --text "I'm Bob" --session user1

# Build from stdin
cat notes.md | cogos build --session user1

Chat

Chat with memory-augmented responses:
# Single-shot chat
cogos chat --message "What do I like?" --session user1

# Interactive chat
cogos chat --session user1

Interactive Chat Commands

When in interactive chat mode (cogos chat):
CommandDescription
/build <text>Add memory inline
/schemasList registered schemas
quit / exitEnd the session

Schemas

Inspect registered schemas:
cogos schemas

Serve

Start the API server:
# Default settings
cogos serve

# Custom host and port
cogos serve --host 0.0.0.0 --port 8000

# With preset template
cogos serve --port 8000 --template general

Summary

CommandDescription
cogos initInitialize project (config + templates)
cogos buildProcess text into memory
cogos chatChat with memory
cogos schemasInspect schemas
cogos serveStart API server + Web UI