Five-minute quickstart¶

With the CLI installed, you can run Colossus using its built-in echo provider. This first run needs no model account, API key, or network connection.

1. Create a folder¶

mkdir colossus-quickstart
cd colossus-quickstart

New-Item -ItemType Directory colossus-quickstart
Set-Location colossus-quickstart

2. Initialize and run¶

colossus config init --local \
  --access-profile development \
  --sandbox-profile workspace-development
colossus run "hello from Colossus"

colossus config init --local `
  --access-profile development `
  --sandbox-profile workspace-development
colossus run "hello from Colossus"

The first command creates .colossus/config.yaml with development tools and a workspace-isolating sandbox. Repository reads are available; file changes and shell commands require approval. It will not overwrite an existing file. The run should return hello from Colossus.

3. Find your configuration¶

colossus config effective

Look for resolution.configPath to see the active file. In this folder, edit .colossus/config.yaml to change providers, access, or sandbox settings. Run colossus config show when you want to see the resolved values and defaults.

4. Verify the audit journal¶

colossus audit verify

Verification should complete successfully. This quickstart stores its journal locally without encryption; use protected storage for real data.

What's next?¶