Documentation Index
Fetch the complete documentation index at: https://docs.cogos.natureselect.ai/llms.txt
Use this file to discover all available pages before exploring further.
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):
| Command | Description |
|---|
/build <text> | Add memory inline |
/schemas | List registered schemas |
quit / exit | End the session |
Schemas
Inspect registered schemas:
Serve
Start the API server in the foreground:
# 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
cogos serve runs the server in the foreground (Ctrl+C to stop). For background service management, see the subcommands below.
Service management subcommands
Only one CogOS daemon can run at a time. If a daemon is already running, start will refuse to launch a new one regardless of the port specified. Use stop first, then start with a new port.
Port can be set via the --port flag (highest priority) or in configs/cogos.yaml under server.port (default: 8000).
| Command | Description |
|---|
cogos serve start | Start as a background daemon |
cogos serve start --autostart | Start daemon + enable auto-start on boot (systemd) |
cogos serve stop | Stop the daemon |
cogos serve stop --remove-autostart | Stop daemon + disable auto-start on boot |
cogos serve restart | Restart the daemon |
cogos serve status | Show running status, PID, uptime, memory |
cogos serve logs | View server logs |
# Start as a background daemon (port from config, default 8000)
cogos serve start
# Specify port via flag (overrides config)
cogos serve --port 9000 start
# Start daemon + enable auto-start on boot
cogos serve start --autostart
# Check status
cogos serve status
# Stop the daemon
cogos serve stop
# Stop + disable auto-start
cogos serve stop --remove-autostart
# Restart with a different port
cogos serve --port 9000 restart
# View logs
cogos serve logs -n 100 # last 100 lines
cogos serve logs -f # follow in real time
Summary
| Command | Description |
|---|
cogos init | Initialize project (config + templates) |
cogos build | Process text into memory |
cogos chat | Chat with memory |
cogos schemas | Inspect schemas |
cogos serve | Start API server + Web UI (foreground) |
cogos serve start | Start as background daemon |
cogos serve start --autostart | Start daemon + enable boot auto-start |
cogos serve stop | Stop background daemon |
cogos serve status | Show daemon status |
