opensage web - Interactive Development Entry Point¶

The opensage web command starts an interactive web UI for developing and debugging agents.

CLI Commands¶

opensage web¶

Starts an interactive web UI for agent development and debugging.

uv run opensage web \
  --config /path/to/config.toml \
  --agent /path/to/agent_dir \
  --port 8000 \
  --neo4j_logging  # optional

opensage dependency-check¶

Checks if external dependencies are properly installed.

uv run opensage dependency-check

This command verifies:

CodeQL: Required for CodeQL static analysis features
Docker: Required for native Docker sandbox backend
kubectl: Required for Kubernetes sandbox backend

All dependencies are optional unless you plan to use the corresponding features. The command will show:

Green checkmarks for available dependencies
Yellow warnings for missing optional dependencies
Red errors for missing required dependencies (if any)

Example Output:

Checking OpenSage dependencies...

Checking CodeQL...
  [OK] CodeQL binary found at /path/to/codeql

Checking Docker...
  [OK] Docker daemon is running and accessible

Checking kubectl...
  [WARN] kubectl command not found in PATH. Install kubectl to use Kubernetes backend.
    Note: Only required when using Kubernetes sandbox backend

============================================================
[WARN] Some dependencies missing (2/3 available)

Note: Missing dependencies are optional unless you plan to use
the corresponding features.
============================================================

Workflow details¶

For the full step-by-step workflow (session creation, sandbox initialization, service wiring, request/streaming flow, and cleanup), see opensage web - workflow details.