CLI Commands

OSTwin provides the ostwin CLI plus a set of shell scripts in .agents/ for lifecycle management.

ostwin CLI

The main binary lives at .agents/bin/ostwin and delegates to Python subcommands.

Start a plan execution. This is the primary entry point.

ostwin run PLAN.md
ostwin run PLAN.md --max-rooms 4
ostwin run PLAN.md --dry-run

Flag	Default	Description
`--max-rooms`	`50`	Max concurrent war-rooms
`--dry-run`	`false`	Parse plan, build DAG, but do not execute
`--model`	config default	Override default model for all roles
`--timeout`	`2400`	Global timeout in seconds

Show the current state of all war-rooms.

ostwin status
ostwin status --room room-003
ostwin status --json

Reads status, state_changed_at, and retries from each room directory.

Interactive chat session with a specified role.

ostwin chat --role engineer
ostwin chat --role architect --model claude-opus-4-6

Manage skill discovery and installation.

ostwin skills list
ostwin skills search "web-research"
ostwin skills install <skill-name>

These scripts live under .agents/ and handle system-level operations.

The primary orchestration entry point. Invoked by ostwin run.

.agents/run.sh PLAN.md

Execution chain:

First-time setup. Creates directory structure, installs dependencies, and configures the environment.

.agents/install.sh

Actions performed:

Initializes a new project for OSTwin. Lighter than install.sh — sets up config files without installing dependencies.

.agents/init.sh

Runs health checks against all running components.

.agents/health.sh

Checks:

Start or stop the dashboard stack.

.agents/dashboard.sh start
.agents/dashboard.sh stop

Manages both the FastAPI backend and Next.js frontend. Writes PID to .agents/dashboard.pid.

Tail or search log files.

.agents/logs.sh tail
.agents/logs.sh tail --room room-003
.agents/logs.sh search "error"

Synchronize skills from ClawhHub or a Git repository.

.agents/sync-skills.sh
.agents/sync-skills.sh --source github

Remove OSTwin from the project. Cleans up .agents/ artifacts but preserves config.json by default.

.agents/uninstall.sh
.agents/uninstall.sh --purge   # removes config.json too

Located under .agents/memory/:

Script	Purpose
`start-memory-daemon.sh`	Launch the MCP memory server
`switch-memory-transport.sh`	Toggle between stdio and SSE transport

Located under .agents/daemons/macos-host/: