Skip to content

Capabilities & Limitations

Last reviewed: July 15, 2026.

This matrix describes behavior available today. It does not promise roadmap work or compare Colony Cloud subscription tiers.

Supported means the capability is available through the documented product path. Conditional means it has an important provider, deployment, configuration, or access-surface constraint. Not available means the product path does not currently provide it. Deprecated means the surface remains present for compatibility but should not be used for new operations.

CapabilityColony CloudSelf-hosted / OSSConstraints and access surfaceNext step
Managed control planeSupportedNot availableCloud operates the API, database, dashboard, and managed scheduling.Cloud onboarding
Self-managed control planeNot availableSupportedYou operate Postgres, the Mayor, Workers, monitor, credentials, upgrades, and backups.Self-host getting started
GitHub issues, repositories, and pull requestsSupportedSupportedCloud uses GitHub Apps. Self-host supports GitHub Apps or PAT-based authentication.Connect a repository · GitHub App setup
Azure DevOps Repos, work items, and pull requestsNot availableSupportedSelf-host uses ADO PATs, work-item mappings, tags, and service hooks.Connect Azure DevOps
Provider webhooksSupportedSupportedCloud manages GitHub delivery. Self-host webhooks are optional and support GitHub or ADO when configured.Troubleshoot webhooks
Polling fallbackConditionalSupportedSelf-host continues full-sync polling when webhooks are absent or inactive. Cloud provider delivery is managed by the service.Troubleshoot webhooks
CapabilityColony CloudSelf-hosted / OSSConstraints and access surfaceNext step
Tagged or all-issue intakeSupportedSupportedTagged intake is the safer rollout mode; changing intake affects only newly discovered work.Configure intake
Autonomous issue implementationSupportedSupportedRequires provider access, a healthy Worker, reproducible setup, and a workflow that can route the issue.Zero to first merge
External review of human-authored PRsSupportedConditionalGitHub only. The review verdict does not itself override branch protection or merge policy.Set up external PR review
Built-in workflowsSupportedSupportedNew issues pin a workflow ID and version; in-flight issues keep their snapshot.The Workflow
Custom workflow authoring and registrationConditionalSupportedCloud can validate, register, and inspect definitions, but arbitrary registered definitions are not currently selected by the runtime as if they were built-ins. Self-host can resolve config-supplied or repository .colony/workflow.yaml definitions.Author a custom workflow
Per-issue workflow routingConditionalSupportedRouting rules must reference a workflow the runtime can resolve. Unknown workflow IDs fail intake instead of silently falling back.Configure intake
Automatic mergeSupportedSupportedRequires passing review/check policy and an operations identity distinct from the PR author when provider rules prohibit self-approval.Configure merge policy
Branch protection setupConditionalConditionalcolony init can create GitHub rulesets and an ADO minimum-reviewer policy when credentials have administration rights. Existing organization rules may require manual alignment.Configure merge policy
Epics, subtasks, and dependenciesSupportedSupportedFeature branches, automatic subtask merge, and final human review depend on epic configuration.Operate epics
CapabilityColony CloudSelf-hosted / OSSConstraints and access surfaceNext step
Strategy charters and proposalsSupportedSupportedStrategy constrains and prioritizes work; it does not bypass the normal pipeline or human gates.Strategy
Self-improvement tracksSupportedSupportedTracks share Worker capacity with normal issues and allow only one open linked issue per track.Roll out SI tracks
SI track management in colony tracksNot availableDeprecatedThe CLI manages legacy file-backed tracks, not the Postgres records shown by the monitor dashboard.Roll out SI tracks
Repository intelligenceSupportedSupportedCollection, retrieval, and prompt injection have separate configuration and maturity controls.Agents and intelligence
Guided issue drafting and decompositionSupportedConditionalCloud provides Issue Intake Studio. Self-host provides CLI and MCP issue/plan tooling rather than the Cloud wizard.Issue Intake Studio · MCP
CapabilityColony CloudSelf-hosted / OSSConstraints and access surfaceNext step
Managed WorkersSupportedNot availableCloud supplies managed capacity subject to the organization’s concurrency and plan limits.Operate Workers
BYO or self-managed WorkersSupportedSupportedCloud BYO Workers still require the Cloud control plane and network access. Self-host Workers use the installation’s Postgres queue.Operate Workers
Pipeline dashboardSupportedSupportedCloud and the self-host monitor expose different navigation and controls.Cloud dashboards · Monitor dashboard
Operational CLIConditionalSupportedThe self-host CLI has direct database and process-control commands. Cloud CLI support is limited to documented Cloud-aware commands.CLI reference
HTTP APISupportedSupportedAuthentication, route prefixes, and available control operations differ by deployment.Cloud API · Self-host API
MCP toolsSupportedSupportedAvailable write operations depend on authentication, provider permissions, and the specific MCP server.Cloud MCP · Self-host MCP
Dead-letter inspection and recoveryConditionalSupportedCloud exposes authenticated API operations but no row-level dashboard Retry/Resolve controls. Self-host provides CLI operations.Recover a dead letter
Worker drain and task reclaimSupportedConditionalCloud exposes Worker drain/reclaim controls. Self-host can inspect/reclaim tasks and gracefully stop the installation; rolling capacity requires more than one Worker.Operate Workers
Model routing and cost controlsSupportedSupportedAvailability of a model still depends on configured provider credentials and engine support.Tune routing and caps
Configuration hot reloadSupportedConditionalOnly declared reloadable keys apply live. Provider identities, repositories, database settings, commands, and other startup fields require redeploy.Rotate credentials
Credential and secret managementSupportedSupportedCloud stores supported secrets and Worker tokens. Self-host operators manage environment variables, App keys, mounted feed credentials, and restarts.Rotate credentials
Backup, upgrade, and rollbackManaged by ColonyOperator responsibilitySelf-host database migrations run forward automatically; rollback may require restoring a matching pre-upgrade database backup.Upgrade and roll back