CLI - CogOS

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:

cogos 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

When invoked without a subcommand, 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

See Service management for details on daemon mode, auto-start, and log management.

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

​Init

​Build

​Chat

​Interactive chat commands

​Schemas

​Serve

​Service management subcommands

​Summary