cloop

command module
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 13, 2026 License: MIT Imports: 1 Imported by: 0

README

cloop

CI Docs

Give it a goal. It writes the plan, then works the plan.

cloop decomposes a goal into a prioritised list of tasks, executes them one at a time through an AI coding agent, and keeps a durable record of what it did. The plan is the thing you read, edit and argue with — not a black box you watch scroll past.

📖 Documentation · Getting started · How it works

Quick start

go install github.com/blechschmidt/cloop@latest

cd ~/src/my-project
cloop init "Add a health check endpoint to the HTTP server"
cloop run

No Go toolchain? Grab a static binary for Linux or macOS from the latest release — see Installation for the checksum-verifying one-liner.

That is the whole first run. cloop calls your provider once to turn the goal into a numbered plan, then works through it — writing code, running your tests, and recording the result of each task before it starts the next one.

cloop status     # the goal, the provider, and where the plan stands
cloop log        # what it has done, step by step
cloop ui         # the same thing in a browser, live

Your first project walks through what happens between those commands, and what to do when a task fails.

Requirements
  • Go 1.25+ to build it (go.mod pins the toolchain).
  • A provider. The default is the Claude Code CLI, which needs claude on your PATH and a logged-in session. The Anthropic, OpenAI and Ollama backends need only an API key — or nothing at all, in Ollama's case.

Building from source instead:

git clone https://github.com/blechschmidt/cloop.git
cd cloop && go build -o cloop .

Why the plan is the product

An agent that runs until it decides it is finished gives you one artefact: a transcript. cloop's is a plan, and that difference is the design.

Every unit of work is a task with an identity, a status and a stored result. So progress survives a restart, a task can be picked up by a different machine than started it, and a failure names the task it belongs to instead of scrolling past. When a task fails, cloop retries it with a mutated prompt before giving up, and stops the run after three consecutive failures rather than thrashing.

When the plan drains, --auto-evolve has the agent propose new work — and that work arrives as tasks you can read and reject, not as more transcript.

Task management

Providers

Switch with --provider, or set a default with cloop config set provider <name>.

Provider What it is Auth
claudecode the Claude Code CLI (default) an existing claude login
anthropic the Anthropic API directly ANTHROPIC_API_KEY
openai Chat Completions, including OpenAI-compatible endpoints OPENAI_API_KEY
ollama a local Ollama server — no key, no cost none

cloop providers --test checks what is configured and whether it answers. There is also a mock provider for tests and CI, which never calls the network.

See choosing and configuring a provider for how provider and model are actually resolved, and which environment variables override which.

Documentation

The full documentation is published at blechschmidt.github.io/cloop, and its source is docs/.
Getting started install, your first project, how the loop works, providers, the dashboard
Executor architecture how a task travels from the orchestrator to a sandbox and back — the four backends, placement, health supervision, failover, remote agent enrollment
Security model the four trust boundaries, the no-host-execution guarantee, SSO and RBAC, and a table mapping every guarantee to the test that checks it
Threat model STRIDE per boundary, with an honest residual-risk column
Secrets and egress granting a GitHub repo/PAT, kubeconfig, registry login or Internet lease, with TTLs and constraints
Git interception proxy letting a sandbox push to some branches and not others without handing it a credential that could reach the rest
Kata Containers giving a sandbox its own kernel
Operator runbook backup and restore, audit verification, key rotation, upgrade, rollback, incident playbooks
Command reference every command and flag
Configuration reference every .cloop/config.yaml key
Per-project sandbox .cloop/sandbox.yaml — the image, setup steps, ceilings and mounts a project's tasks run under
Deployment container image, docker-compose evaluation stack, Helm chart

cloop <command> --help covers anything not written up.

Running it for a team

Everything above is one process on one machine. cloop also runs as a multi-user hub with SSO, RBAC, brokered credentials and isolated executors. The hub itself never spawns an agent: work runs in a container, on an enrolled edge device, or as a Kubernetes Pod.

cloop hub bootstrap --external-url https://cloop.example.com \
  --oidc-issuer https://idp.example.com --oidc-client-id cloop-hub

That writes a configuration with executors.allow_host_process: false and default_role: none — no host execution, deny by default. From there, read the security model, then the operator runbook.

Security conformance suite

tests/security/ is an executable specification of the threat model. Every check asserts a property whose absence is invisible at runtime: the feature still works, the logs look normal, and only an attacker notices the difference.

go test -race ./tests/security/

It runs as a required CI job. Each guarantee is mapped to the test that checks it in the security model.

Development

make build          # compile ./cloop
make test           # unit tests (race + coverage) and the e2e suite
make docs-serve     # live-preview the documentation site

See CONTRIBUTING.md for the full workflow, and the Makefile for fuzzing and the docker-compose evaluation stack.

License

MIT

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

View all Source files

Directories

Path Synopsis
internal
hometest
Package hometest isolates a test binary from the developer's real home directory.
 Package hometest isolates a test binary from the developer's real home directory.
pkg
acceptance
Package acceptance generates formal acceptance criteria for tasks using AI.
 Package acceptance generates formal acceptance criteria for tasks using AI.
adr
Package adr manages Architectural Decision Records — markdown files with YAML frontmatter that capture significant design choices, their context, and their consequences.
 Package adr manages Architectural Decision Records — markdown files with YAML frontmatter that capture significant design choices, their context, and their consequences.
agent
aipair
Package aipair implements an interactive streaming AI coding assistant REPL scoped to a specific task.
 Package aipair implements an interactive streaming AI coding assistant REPL scoped to a specific task.
alert
Package alert implements threshold-based monitoring rules for cloop plans.
 Package alert implements threshold-based monitoring rules for cloop plans.
analyze
Package analyze implements AI-powered codebase bootstrapping for cloop.
 Package analyze implements AI-powered codebase bootstrapping for cloop.
apierror
Package apierror defines a structured error type and wire format used by cloop's HTTP servers (pkg/ui and pkg/apiserver).
 Package apierror defines a structured error type and wire format used by cloop's HTTP servers (pkg/ui and pkg/apiserver).
apiserver
Package apiserver implements a standalone REST API server that exposes all cloop functionality over HTTP with an OpenAPI 3.0 spec at /openapi.json.
 Package apiserver implements a standalone REST API server that exposes all cloop functionality over HTTP with an OpenAPI 3.0 spec at /openapi.json.
apitoken
Package apitoken implements scoped, expiring, individually revocable API tokens for non-interactive access to the cloop hub (Task 20175).
 Package apitoken implements scoped, expiring, individually revocable API tokens for non-interactive access to the cloop hub (Task 20175).
approvalgate
Package approvalgate implements human-in-the-loop approval gates for PM task execution.
 Package approvalgate implements human-in-the-loop approval gates for PM task execution.
archive
Package archive manages the task archive store (.cloop/archive.json).
 Package archive manages the task archive store (.cloop/archive.json).
artifact
Package artifact persists the full AI response for each PM task as a human-readable Markdown file with YAML frontmatter under .cloop/tasks/.
 Package artifact persists the full AI response for each PM task as a human-readable Markdown file with YAML frontmatter under .cloop/tasks/.
ask
Package ask provides AI Q&A with full project context.
 Package ask provides AI Q&A with full project context.
atomicfile
Package atomicfile centralises crash-safe file writes used across cloop's persistent stores (state, profile, checkpoint, kb, alert, eval, metrics, trace, daemon, and more).
 Package atomicfile centralises crash-safe file writes used across cloop's persistent stores (state, profile, checkpoint, kb, alert, eval, metrics, trace, daemon, and more).
audit
Package audit implements security and compliance scanning for cloop projects.
 Package audit implements security and compliance scanning for cloop projects.
auditexport
Package auditexport serialises the tamper-evident audit trail into the formats a compliance pipeline consumes (Task 20167).
 Package auditexport serialises the tamper-evident audit trail into the formats a compliance pipeline consumes (Task 20167).
auditretention
Package auditretention seals and prunes the audit trail (Task 20218).
 Package auditretention seals and prunes the audit trail (Task 20218).
authz
Package authz implements claim-based role-based access control for the cloop hub.
 Package authz implements claim-based role-based access control for the cloop hub.
autodeps
Package autodeps provides AI-powered automatic dependency inference for task plans.
 Package autodeps provides AI-powered automatic dependency inference for task plans.
backlog
Package backlog implements AI-driven product backlog generation.
 Package backlog implements AI-driven product backlog generation.
batchedit
Package batchedit implements a full-screen bubbletea TUI for bulk-editing multiple tasks at once.
 Package batchedit implements a full-screen bubbletea TUI for bulk-editing multiple tasks at once.
bench
Package bench provides side-by-side provider benchmarking for cloop.
 Package bench provides side-by-side provider benchmarking for cloop.
blocker
Package blocker detects blocked tasks and generates AI-powered resolution suggestions.
 Package blocker detects blocked tasks and generates AI-powered resolution suggestions.
boundedread
Package boundedread reads user-supplied files with an explicit size cap so pointing cloop at a runaway artifact (a 5 GB log, a 2 GB binary) cannot OOM the process.
 Package boundedread reads user-supplied files with an explicit size cap so pointing cloop at a runaway artifact (a 5 GB log, a 2 GB binary) cannot OOM the process.
brief
Package brief generates one-page AI executive project briefs for stakeholder updates.
 Package brief generates one-page AI executive project briefs for stakeholder updates.
budget
Package budget provides daily token and cost budget enforcement for cloop.
 Package budget provides daily token and cost budget enforcement for cloop.
cache
Package cache provides a disk-based LRU response cache for AI provider calls.
 Package cache provides a disk-based LRU response cache for AI provider calls.
calibrate
Package calibrate computes effort-estimate calibration metrics from historical task actuals and asks the AI to suggest updated estimates for pending tasks.
 Package calibrate computes effort-estimate calibration metrics from historical task actuals and asks the AI to suggest updated estimates for pending tasks.
changelog
Package changelog implements AI-generated CHANGELOG synthesis from task history.
 Package changelog implements AI-generated CHANGELOG synthesis from task history.
chaos
Package chaos provides a fault-injection framework that lets cloop's resilience claims (retry budgets, circuit breakers, busy-timeout pragmas, graceful shutdown) be exercised against simulated failures rather than just unit-tested.
 Package chaos provides a fault-injection framework that lets cloop's resilience claims (retry budgets, circuit breakers, busy-timeout pragmas, graceful shutdown) be exercised against simulated failures rather than just unit-tested.
chat
Package chat provides an interactive conversational PM interface.
 Package chat provides an interactive conversational PM interface.
checkpoint
Package checkpoint provides mid-execution checkpointing for PM mode.
 Package checkpoint provides mid-execution checkpointing for PM mode.
cipipe
Package cipipe generates CI/CD pipeline configurations tailored to a project's tech stack and cloop task plan.
 Package cipipe generates CI/CD pipeline configurations tailored to a project's tech stack and cloop task plan.
clarify
Package clarify implements an interactive goal clarification dialog.
 Package clarify implements an interactive goal clarification dialog.
claudecodeauth
Package claudecodeauth wraps the `claude auth` subcommand so the Web UI can drive Claude Code login/logout/status from the browser.
 Package claudecodeauth wraps the `claude auth` subcommand so the Web UI can drive Claude Code login/logout/status from the browser.
coach
Package coach provides per-task AI coaching tips before task execution.
 Package coach provides per-task AI coaching tips before task execution.
commitmsg
Package commitmsg implements AI-powered conventional commit message generation.
 Package commitmsg implements AI-powered conventional commit message generation.
compact
Package compact prunes old artifacts, snapshots, and checkpoints from a cloop project directory to reclaim disk space.
 Package compact prunes old artifacts, snapshots, and checkpoints from a cloop project directory to reclaim disk space.
compare
Package compare provides multi-provider benchmarking: run the same prompt against several AI providers simultaneously and compare results.
 Package compare provides multi-provider benchmarking: run the same prompt against several AI providers simultaneously and compare results.
complexity
Package complexity implements AI-powered T-shirt size complexity estimation for PM tasks.
 Package complexity implements AI-powered T-shirt size complexity estimation for PM tasks.
condition
Package condition evaluates task execution conditions before a task is run.
 Package condition evaluates task execution conditions before a task is run.
config
Package config manages the .cloop/config.yaml project configuration file.
 Package config manages the .cloop/config.yaml project configuration file.
configdiff
Package configdiff compares the canonical .cloop/config.yaml against the SQLite-mirrored copy stored by Save() (see pkg/config).
 Package configdiff compares the canonical .cloop/config.yaml against the SQLite-mirrored copy stored by Save() (see pkg/config).
configvalidate
Package configvalidate implements schema and semantic validation for cloop config and state.
 Package configvalidate implements schema and semantic validation for cloop config and state.
consensus
Package consensus implements multi-model voting for critical tasks.
 Package consensus implements multi-model voting for critical tasks.
contextgraph
Package contextgraph builds a directed knowledge graph that links tasks, their dependency edges, associated file artifacts, KB entries, task annotations, and git commits into a single queryable structure.
 Package contextgraph builds a directed knowledge graph that links tasks, their dependency edges, associated file artifacts, KB entries, task annotations, and git commits into a single queryable structure.
cost
Package cost provides token-cost estimation for common AI model providers.
 Package cost provides token-cost estimation for common AI model providers.
critique
Package critique provides an AI adversarial plan review ("devil's advocate") that pressure-tests the current plan before execution.
 Package critique provides an AI adversarial plan review ("devil's advocate") that pressure-tests the current plan before execution.
ctxedit
Package ctxedit builds, annotates, persists, and loads context overrides for PM tasks.
 Package ctxedit builds, annotates, persists, and loads context overrides for PM tasks.
daemon
Package daemon manages the cloop background daemon process.
 Package daemon manages the cloop background daemon process.
dbbackup
Package dbbackup creates and restores hot backups of the cloop SQLite state database (Task 20115).
 Package dbbackup creates and restores hot backups of the cloop SQLite state database (Task 20115).
dbmaintain
Package dbmaintain implements VACUUM + ANALYZE maintenance for the cloop state database (Task 20107).
 Package dbmaintain implements VACUUM + ANALYZE maintenance for the cloop state database (Task 20107).
dbverify
Package dbverify runs SQLite integrity checks against the cloop state database.
 Package dbverify runs SQLite integrity checks against the cloop state database.
decompose
Package decompose implements recursive AI sub-task expansion for a single task.
 Package decompose implements recursive AI sub-task expansion for a single task.
depseditor
Package depseditor provides an interactive TUI for viewing and editing task dependencies.
 Package depseditor provides an interactive TUI for viewing and editing task dependencies.
diagnosis
Package diagnosis provides AI-powered failure analysis for PM tasks.
 Package diagnosis provides AI-powered failure analysis for PM tasks.
diskusage
Package diskusage measures what a project's .cloop directory actually costs on disk, broken down by the thing that produced it (Task 20229).
 Package diskusage measures what a project's .cloop directory actually costs on disk, broken down by the thing that produced it (Task 20229).
docs
Package docs implements AI-powered documentation maintenance for cloop projects.
 Package docs implements AI-powered documentation maintenance for cloop projects.
doctor
Package doctor implements environment and configuration health checks for cloop.
 Package doctor implements environment and configuration health checks for cloop.
egressbroker
Package egressbroker leases the control plane's Internet connection to isolated executors through an authenticated forward proxy.
 Package egressbroker leases the control plane's Internet connection to isolated executors through an authenticated forward proxy.
env
Package env manages per-project environment variables for cloop.
 Package env manages per-project environment variables for cloop.
epic
Package epic clusters a task plan into named epics/themes using AI.
 Package epic clusters a task plan into named epics/themes using AI.
eval
Package eval scores completed task output against a configurable rubric by calling the AI provider once per criterion and aggregating weighted scores.
 Package eval scores completed task output against a configurable rubric by calling the AI provider once per criterion and aggregating weighted scores.
eventlog
Package eventlog wraps the audit log for forensic and compliance use cases (Task 20119): tail (with optional follow), filter, replay into a fresh database, and verify the SHA-256 hash chain.
 Package eventlog wraps the audit log for forensic and compliance use cases (Task 20119): tail (with optional follow), filter, replay into a fresh database, and verify the SHA-256 hash chain.
executor
Package executor defines cloop's pluggable execution backend abstraction.
 Package executor defines cloop's pluggable execution backend abstraction.
executor/agent
Package agent is the device side of cloop's remote executor: the process that runs on an edge device, dials out to a control plane, and executes the workloads it is sent.
 Package agent is the device side of cloop's remote executor: the process that runs on an edge device, dials out to a control plane, and executes the workloads it is sent.
executor/container
Package container implements the executor.Executor interface on top of the Docker/Podman command line, running each workload in a resource- and network-isolated sandbox.
 Package container implements the executor.Executor interface on top of the Docker/Podman command line, running each workload in a resource- and network-isolated sandbox.
executor/gitcreds
Package gitcreds leases the credential a git workspace fetch needs.
 Package gitcreds leases the credential a git workspace fetch needs.
executor/gitprovision
Package gitprovision materialises a workload's source tree where the workload is about to run.
 Package gitprovision materialises a workload's source tree where the workload is about to run.
executor/gitproxycreds
Package gitproxycreds interposes a git interception proxy between a sandbox and the forge.
 Package gitproxycreds interposes a git interception proxy between a sandbox and the forge.
executor/gitwriteback
Package gitwriteback turns the files a harness changed into something the hub can merge.
 Package gitwriteback turns the files a harness changed into something the hub can merge.
executor/install
Package install turns an enrollment bundle into a running, restart-on-boot, hardened cloop executor agent on an edge device.
 Package install turns an enrollment bundle into a running, restart-on-boot, hardened cloop executor agent on an edge device.
executor/internal/logbus
Package logbus fans one workload's output out to any number of live subscribers, with a bounded replay backlog for late joiners.
 Package logbus fans one workload's output out to any number of live subscribers, with a bounded replay backlog for late joiners.
executor/kubernetes
Package kubernetes implements the executor.Executor interface by running each workload as an ephemeral Pod in a Kubernetes cluster.
 Package kubernetes implements the executor.Executor interface by running each workload as an ephemeral Pod in a Kubernetes cluster.
executor/localprocess
Package localprocess implements the executor.Executor interface by forking child processes on the control-plane host.
 Package localprocess implements the executor.Executor interface by forking child processes on the control-plane host.
executor/reconcile
Package reconcile turns the executors section of a config file into registered, preflighted executors — once, in one place, for every entry point that hosts a control plane (Task 20170).
 Package reconcile turns the executors section of a config file into registered, preflighted executors — once, in one place, for every entry point that hosts a control plane (Task 20170).
executor/remote
Package remote implements the control-plane half of cloop's remote executor: a driver that satisfies executor.Executor by proxying frames to a cloop agent running on another machine.
 Package remote implements the control-plane half of cloop's remote executor: a driver that satisfies executor.Executor by proxying frames to a cloop agent running on another machine.
executorstore
Package executorstore backs the remote-executor enrollment flow with SQLite.
 Package executorstore backs the remote-executor enrollment flow with SQLite.
explain
Package explain generates human-readable pre-execution narrations of task plans.
 Package explain generates human-readable pre-execution narrations of task plans.
feedback
Package feedback stores human ratings on AI task outputs.
 Package feedback stores human ratings on AI task outputs.
filewatch
Package filewatch monitors file/directory patterns and triggers plan re-evaluation when watched files change.
 Package filewatch monitors file/directory patterns and triggers plan re-evaluation when watched files change.
finetune
Package finetune exports completed task I/O pairs as JSONL files suitable for LLM fine-tuning.
 Package finetune exports completed task I/O pairs as JSONL files suitable for LLM fine-tuning.
flow
Package flow implements a declarative automation pipeline runner.
 Package flow implements a declarative automation pipeline runner.
forecast
Package forecast provides AI-powered project completion forecasting for cloop.
 Package forecast provides AI-powered project completion forecasting for cloop.
git
Package git provides helpers for integrating cloop task execution with git workflows.
 Package git provides helpers for integrating cloop task execution with git workflows.
github
Package github provides a lightweight GitHub REST API client for cloop.
 Package github provides a lightweight GitHub REST API client for cloop.
githubsync
Package githubsync implements two-way synchronization between cloop PM tasks and GitHub Issues.
 Package githubsync implements two-way synchronization between cloop PM tasks and GitHub Issues.
gitproxy
Package gitproxy is a git smart-HTTP interception proxy that runs outside the sandbox and decides, per ref, what a sandbox is allowed to push.
 Package gitproxy is a git smart-HTTP interception proxy that runs outside the sandbox and decides, per ref, what a sandbox is allowed to push.
globalbudget
Package globalbudget manages a global (cross-project) daily token and cost budget stored in ~/.config/cloop/budget.yaml plus a global cost ledger at ~/.config/cloop/costs.jsonl.
 Package globalbudget manages a global (cross-project) daily token and cost budget stored in ~/.config/cloop/budget.yaml plus a global cost ledger at ~/.config/cloop/costs.jsonl.
hooks
Package hooks executes user-defined shell commands before and after tasks and plans.
 Package hooks executes user-defined shell commands before and after tasks and plans.
hubdoctor
Package hubdoctor diagnoses a cloop *control plane* — the thing an operator deploys — as distinct from pkg/doctor, which diagnoses a developer's checkout.
 Package hubdoctor diagnoses a cloop *control plane* — the thing an operator deploys — as distinct from pkg/doctor, which diagnoses a developer's checkout.
hublease
Package hublease fences a cloop control plane to one process (Task 20214).
 Package hublease fences a cloop control plane to one process (Task 20214).
hubmetrics
Package hubmetrics is the process-level metrics registry for a long-lived cloop hub.
 Package hubmetrics is the process-level metrics registry for a long-lived cloop hub.
ical
Package ical generates RFC 5545 iCalendar documents from a cloop task plan.
 Package ical generates RFC 5545 iCalendar documents from a cloop task plan.
imagepolicy
Package imagepolicy decides whether a container image may be used to execute a project's code, and pins the answer to a digest.
 Package imagepolicy decides whether a container image may be used to execute a project's code, and pins the answer to a digest.
impact
Package impact implements AI-powered strategic impact scoring for PM tasks.
 Package impact implements AI-powered strategic impact scoring for PM tasks.
importer
Package importer parses CSV exports from Jira, Linear, and GitHub Issues and converts them into cloop pm.Task slices ready for appending to a plan.
 Package importer parses CSV exports from Jira, Linear, and GitHub Issues and converts them into cloop pm.Task slices ready for appending to a plan.
insights
Package insights provides AI-powered project analytics and recommendations.
 Package insights provides AI-powered project analytics and recommendations.
integrations
Package integrations provides a unified health dashboard for all external service integrations configured in a cloop project.
 Package integrations provides a unified health dashboard for all external service integrations configured in a cloop project.
janitor
Package janitor bounds a project's .cloop directory automatically (Task 20229).
 Package janitor bounds a project's .cloop directory automatically (Task 20229).
journal
Package journal provides a per-task decision log with AI summarization.
 Package journal provides a per-task decision log with AI summarization.
kanban
Package kanban implements a full-screen bubbletea kanban board for cloop.
 Package kanban implements a full-screen bubbletea kanban board for cloop.
kb
Package kb implements a persistent project-scoped knowledge base stored in .cloop/kb.json.
 Package kb implements a persistent project-scoped knowledge base stored in .cloop/kb.json.
learning
Package learning implements cross-session AI learning memory for cloop.
 Package learning implements cross-session AI learning memory for cloop.
linter
Package linter performs static and AI-based quality analysis on cloop task plans.
 Package linter performs static and AI-based quality analysis on cloop task plans.
logger
Package logger provides structured logging for cloop, backed by Go's standard library log/slog package.
 Package logger provides structured logging for cloop, backed by Go's standard library log/slog package.
logtail
Package logtail reads the last N lines of a log file without loading the entire file into memory.
 Package logtail reads the last N lines of a log file without loading the entire file into memory.
mcp
Package mcp implements a Model Context Protocol (MCP) server over stdio.
 Package mcp implements a Model Context Protocol (MCP) server over stdio.
memory
Package memory implements persistent session learning for cloop.
 Package memory implements persistent session learning for cloop.
mergequeue
Package mergequeue serializes git merges of task branches back to a base branch.
 Package mergequeue serializes git merges of task branches back to a base branch.
mergeresolve
Package mergeresolve provides AI-driven automatic resolution of git merge conflicts produced by the mergequeue when two parallel task branches both touch the same lines of a file.
 Package mergeresolve provides AI-driven automatic resolution of git merge conflicts produced by the mergequeue when two parallel task branches both touch the same lines of a file.
metrics
Package metrics provides structured metrics collection and export for cloop runs.
 Package metrics provides structured metrics collection and export for cloop runs.
microstandup
Package microstandup generates focused per-task micro-standup cards with blocker detection.
 Package microstandup generates focused per-task micro-standup cards with blocker detection.
migrate
Package migrate provides versioned schema upgrade and repair for .cloop directories.
 Package migrate provides versioned schema upgrade and repair for .cloop directories.
milestone
Package milestone implements sprint/release planning for cloop PM mode.
 Package milestone implements sprint/release planning for cloop PM mode.
multiagent
Package multiagent implements specialist sub-agent task execution.
 Package multiagent implements specialist sub-agent task execution.
multiui
Package multiui manages a registry of cloop projects for the multi-project web UI dashboard.
 Package multiui manages a registry of cloop projects for the multi-project web UI dashboard.
naming
Package naming provides AI-powered batch title normalization for cloop tasks.
 Package naming provides AI-powered batch title normalization for cloop tasks.
narrative
Package narrative generates polished executive-level project story reports aimed at non-technical stakeholders.
 Package narrative generates polished executive-level project story reports aimed at non-technical stakeholders.
netfilter
Package netfilter compiles an egress authorisation into an IP-layer firewall.
 Package netfilter compiles an egress authorisation into an IP-layer firewall.
nlcli
Package nlcli implements natural language CLI dispatch: it sends a free-text user instruction plus the list of available cloop commands to an AI provider and receives back a concrete CLI invocation that can be re-executed.
 Package nlcli implements natural language CLI dispatch: it sends a free-text user instruction plus the list of available cloop commands to an AI provider and receives back a concrete CLI invocation that can be re-executed.
notebook
Package notebook generates a rich, shareable project notebook from a cloop plan.
 Package notebook generates a rich, shareable project notebook from a cloop plan.
notify
Package notify provides OS desktop notification support and webhook notifications.
 Package notify provides OS desktop notification support and webhook notifications.
notifywizard
Package notifywizard provides an interactive terminal wizard for configuring cloop notification channels: desktop notifications, Slack webhooks, Discord webhooks, and custom HTTP webhooks.
 Package notifywizard provides an interactive terminal wizard for configuring cloop notification channels: desktop notifications, Slack webhooks, Discord webhooks, and custom HTTP webhooks.
oidcauth
Package oidcauth implements a minimal OpenID Connect relying party for the cloop web dashboard: the authorization-code flow with PKCE for a confidential client, ID-token validation against the provider's JWKS, and in-memory cookie-backed sessions.
 Package oidcauth implements a minimal OpenID Connect relying party for the cloop web dashboard: the authorization-code flow with PKCE for a confidential client, ID-token validation against the provider's JWKS, and in-memory cookie-backed sessions.
onboard
Package onboard implements AI-generated contributor onboarding guide generation.
 Package onboard implements AI-generated contributor onboarding guide generation.
optimizer
Package optimizer provides AI-driven plan optimization before execution.
 Package optimizer provides AI-driven plan optimization before execution.
orchestrator
outlive
Package outlive lets a long-running cloop process survive the death of the control plane that started it.
 Package outlive lets a long-running cloop process survive the death of the control plane that started it.
perfprofile
Package perfprofile analyzes timing data from task checkpoints and the cost ledger to identify execution bottlenecks across a plan run.
 Package perfprofile analyzes timing data from task checkpoints and the cost ledger to identify execution bottlenecks across a plan run.
pivot
Package pivot implements AI-powered goal pivot and plan re-generation.
 Package pivot implements AI-powered goal pivot and plan re-generation.
plandiff
Package plandiff provides AI-narrated comparison of plan snapshots.
 Package plandiff provides AI-narrated comparison of plan snapshots.
planedit
Package planedit provides AI-powered natural-language plan mutation.
 Package planedit provides AI-powered natural-language plan mutation.
planio
Package planio implements portable plan export and import for sharing cloop plans between teams without requiring git access.
 Package planio implements portable plan export and import for sharing cloop plans between teams without requiring git access.
plugin
Package plugin implements discovery and execution of shell-script plugins for cloop.
 Package plugin implements discovery and execution of shell-script plugins for cloop.
pm
Package pm — chain pipeline helpers.
 Package pm — chain pipeline helpers.
pr
Package pr implements AI-powered pull request description generation.
 Package pr implements AI-powered pull request description generation.
prioritize
Package prioritize provides AI-powered task reprioritization for cloop PM mode.
 Package prioritize provides AI-powered task reprioritization for cloop PM mode.
procgroup
Package procgroup inspects and drains POSIX process groups.
 Package procgroup inspects and drains POSIX process groups.
profile
Package profile manages named provider/model configuration profiles stored globally in ~/.cloop/profiles.yaml.
 Package profile manages named provider/model configuration profiles stored globally in ~/.cloop/profiles.yaml.
promote
Package promote implements deadline-aware automatic priority escalation.
 Package promote implements deadline-aware automatic priority escalation.
promptopt
Package promptopt implements prompt A/B testing and optimization for cloop.
 Package promptopt implements prompt A/B testing and optimization for cloop.
promptstats
Package promptstats tracks per-task prompt outcomes to learn which prompt patterns correlate with success vs failure.
 Package promptstats tracks per-task prompt outcomes to learn which prompt patterns correlate with success vs failure.
provider
provider/anthropic
Package anthropic provides direct access to the Anthropic Messages API.
 Package anthropic provides direct access to the Anthropic Messages API.
provider/cached
Package cached provides a CachedProvider decorator that wraps any Provider and transparently caches responses to avoid redundant identical API calls.
 Package cached provides a CachedProvider decorator that wraps any Provider and transparently caches responses to avoid redundant identical API calls.
provider/claudecode
Package claudecode wraps the claude CLI binary as a provider.
 Package claudecode wraps the claude CLI binary as a provider.
provider/fallback
Package fallback provides a Provider that tries a list of providers in order, returning the first successful result.
 Package fallback provides a Provider that tries a list of providers in order, returning the first successful result.
provider/mock
Package mock provides a deterministic offline provider for CI and testing.
 Package mock provides a deterministic offline provider for CI and testing.
provider/ollama
Package ollama provides access to locally running Ollama models.
 Package ollama provides access to locally running Ollama models.
provider/openai
Package openai provides access to the OpenAI Chat Completions API and any OpenAI-compatible API (e.g.
 Package openai provides access to the OpenAI Chat Completions API and any OpenAI-compatible API (e.g.
provideraudit
Package provideraudit records every Provider.Complete invocation into a per-project SQLite audit log so the Web UI's "Provider Calls" panel can show recent calls in real time, let users open a modal with the full prompt/response/headers, and replay a call with edited input.
 Package provideraudit records every Provider.Complete invocation into a per-project SQLite audit log so the Web UI's "Provider Calls" panel can show recent calls in real time, let users open a modal with the full prompt/response/headers, and replay a call with edited input.
query
Package query provides natural-language plan search powered by an AI provider.
 Package query provides natural-language plan search powered by an AI provider.
quota
Package quota answers the question pkg/authz does not.
 Package quota answers the question pkg/authz does not.
quotastore
Package quotastore persists per-identity quotas in the hub's own state database (Task 20182).
 Package quotastore persists per-identity quotas in the hub's own state database (Task 20182).
ratelimit
Package ratelimit - claude_limits.go enforces per-project caps on the global Claude Code subscription utilization (5-hour and weekly windows).
 Package ratelimit - claude_limits.go enforces per-project caps on the global Claude Code subscription utilization (5-hour and weekly windows).
recipe
Package recipe implements a named, shareable workflow library for cloop.
 Package recipe implements a named, shareable workflow library for cloop.
release
Package release implements semantic versioning and release automation for cloop.
 Package release implements semantic versioning and release automation for cloop.
reorder
Package reorder implements AI-powered task priority re-ranking for PM mode.
 Package reorder implements AI-powered task priority re-ranking for PM mode.
replay
report
Package report generates rich project reports from cloop state.
 Package report generates rich project reports from cloop state.
reqid
Package reqid provides request-scoped correlation IDs that flow through HTTP middleware, the orchestrator, and provider calls so that every log line, audit entry, and error can be tied back to one logical operation.
 Package reqid provides request-scoped correlation IDs that flow through HTTP middleware, the orchestrator, and provider calls so that every log line, audit entry, and error can be tied back to one logical operation.
retro
Package retro provides AI-powered sprint retrospective analysis for cloop sessions.
 Package retro provides AI-powered sprint retrospective analysis for cloop sessions.
review
Package review provides AI-powered code review for git diffs.
 Package review provides AI-powered code review for git diffs.
risk
Package risk provides AI-powered pre-execution risk assessment for cloop tasks.
 Package risk provides AI-powered pre-execution risk assessment for cloop tasks.
riskmatrix
Package riskmatrix combines impact scoring (pkg/impact) and risk assessment (pkg/risk) to produce a 2D quadrant visualization of all pending tasks.
 Package riskmatrix combines impact scoring (pkg/impact) and risk assessment (pkg/risk) to produce a 2D quadrant visualization of all pending tasks.
roadmap
Package roadmap generates AI-powered quarterly milestone roadmaps from a task plan.
 Package roadmap generates AI-powered quarterly milestone roadmaps from a task plan.
router
Package router maps task roles to specific AI providers.
 Package router maps task roles to specific AI providers.
sandbox
Package sandbox parses and validates .cloop/sandbox.yaml, a repo-committed description of the environment one project's tasks should execute in.
 Package sandbox parses and validates .cloop/sandbox.yaml, a repo-committed description of the environment one project's tasks should execute in.
scaffold
Package scaffold implements AI-powered project scaffolding from a cloop plan.
 Package scaffold implements AI-powered project scaffolding from a cloop plan.
scope
Package scope detects and reports scope creep across plan evolution.
 Package scope detects and reports scope creep across plan evolution.
search
Package search implements unified full-text search across all cloop project artifacts.
 Package search implements unified full-text search across all cloop project artifacts.
secret
Package secret provides AES-256-GCM encrypted project secrets management.
 Package secret provides AES-256-GCM encrypted project secrets management.
secretbroker
Package secretbroker brokers scoped, time-limited credential grants to execution backends.
 Package secretbroker brokers scoped, time-limited credential grants to execution backends.
secretstore
Package secretstore backs the secret broker with SQLite.
 Package secretstore backs the secret broker with SQLite.
securewipe
Package securewipe destroys credential material on disk and says whether it succeeded.
 Package securewipe destroys credential material on disk and says whether it succeeded.
security
Package security provides cryptographic utilities for cloop's data integrity.
 Package security provides cryptographic utilities for cloop's data integrity.
selfimprove
Package selfimprove implements the cloop self-improve meta-command.
 Package selfimprove implements the cloop self-improve meta-command.
session
Package session manages named execution sessions with isolated state.
 Package session manages named execution sessions with isolated state.
sessionstore
Package sessionstore persists cloop dashboard sessions in the hub's own state database, sealing the one piece of credential material a session holds (Task 20176).
 Package sessionstore persists cloop dashboard sessions in the hub's own state database, sealing the one piece of credential material a session holds (Task 20176).
shell
Package shell implements an interactive REPL session combining conversational AI with plan awareness.
 Package shell implements an interactive REPL session combining conversational AI with plan awareness.
simulate
Package simulate provides AI-powered "what-if" scenario analysis for cloop PM projects.
 Package simulate provides AI-powered "what-if" scenario analysis for cloop PM projects.
skill
Package skill implements the reusable prompt macro library.
 Package skill implements the reusable prompt macro library.
snapshot
Package snapshot implements atomic full-project backup and restore for the .cloop directory.
 Package snapshot implements atomic full-project backup and restore for the .cloop directory.
sprint
Package sprint implements AI-powered sprint planning with velocity-based grouping.
 Package sprint implements AI-powered sprint planning with velocity-based grouping.
standup
Package standup generates AI-powered daily standup reports for cloop projects.
 Package standup generates AI-powered daily standup reports for cloop projects.
state
statedb
Package statedb provides a SQLite-backed persistent store for cloop project state.
 Package statedb provides a SQLite-backed persistent store for cloop project state.
stt
Package stt provides speech-to-text transcription via Whisper (local) or Groq API.
 Package stt provides speech-to-text transcription via Whisper (local) or Groq API.
suggest
Package suggest implements AI-driven feature idea generation.
 Package suggest implements AI-driven feature idea generation.
summarize
Package summarize generates AI executive summaries of completed work for stakeholder communication.
 Package summarize generates AI executive summaries of completed work for stakeholder communication.
sync
Package sync implements git-based team plan sharing and merging.
 Package sync implements git-based team plan sharing and merging.
taskadd
Package taskadd provides AI-powered natural language task creation.
 Package taskadd provides AI-powered natural language task creation.
taskqueue
Package taskqueue implements a central SQLite-backed queue that records every unit of work cloop performs — PM task executions, auto-heal retries, evolve discoveries, and externally-added tasks.
 Package taskqueue implements a central SQLite-backed queue that records every unit of work cloop performs — PM task executions, auto-heal retries, evolve discoveries, and externally-added tasks.
taskrecover
Package taskrecover repairs tasks left in_progress by a run that died.
 Package taskrecover repairs tasks left in_progress by a run that died.
taskreplay
Package taskreplay implements a deterministic task replay harness.
 Package taskreplay implements a deterministic task replay harness.
taskstats
Package taskstats aggregates per-task execution analytics from all available cloop data sources: task state, step log tokens, artifact files, and verification results.
 Package taskstats aggregates per-task execution analytics from all available cloop data sources: task state, step log tokens, artifact files, and verification results.
taskwatch
Package taskwatch implements live streaming output tailing for a running cloop PM task.
 Package taskwatch implements live streaming output tailing for a running cloop PM task.
tdd
Package tdd provides AI-generated acceptance criteria and post-execution test verification for cloop PM tasks.
 Package tdd provides AI-generated acceptance criteria and post-execution test verification for cloop PM tasks.
team
Package team implements multi-user task assignment and workload management.
 Package team implements multi-user task assignment and workload management.
teamassign
Package teamassign provides AI-powered automatic task assignment based on inferred skill match between task descriptions and team member history.
 Package teamassign provides AI-powered automatic task assignment based on inferred skill match between task descriptions and team member history.
template
Package template provides a built-in library of project templates for cloop init.
 Package template provides a built-in library of project templates for cloop init.
testgen
Package testgen generates AI-produced test suites for completed PM tasks.
 Package testgen generates AI-produced test suites for completed PM tasks.
testrun
Package testrun detects the project test framework, runs tests, and pipes failures to the AI provider for root-cause diagnosis and fix suggestions.
 Package testrun detects the project test framework, runs tests, and pipes failures to the AI provider for root-cause diagnosis and fix suggestions.
timeline
Package timeline builds and renders Gantt charts for cloop task plans.
 Package timeline builds and renders Gantt charts for cloop task plans.
timetravel
Package timetravel provides an interactive bubbletea TUI for replaying a task's checkpoint history step-by-step.
 Package timetravel provides an interactive bubbletea TUI for replaying a task's checkpoint history step-by-step.
tlsconf
Package tlsconf centralises cloop's transport-security decisions: the server-side TLS parameters for `cloop ui` / `cloop serve`, and the SPKI pinning primitives the executor agent uses to decide whether the TLS peer that answered DNS is really its control plane.
 Package tlsconf centralises cloop's transport-security decisions: the server-side TLS parameters for `cloop ui` / `cloop serve`, and the SPKI pinning primitives the executor agent uses to decide whether the TLS peer that answered DNS is really its control plane.
trace
Package trace correlates recent git commits with PM plan tasks using an AI provider.
 Package trace correlates recent git commits with PM plan tasks using an AI provider.
tracing
Package tracing provides OpenTelemetry distributed tracing for cloop.
 Package tracing provides OpenTelemetry distributed tracing for cloop.
tui
Package tui implements a terminal UI dashboard for cloop using bubbletea and lipgloss.
 Package tui implements a terminal UI dashboard for cloop using bubbletea and lipgloss.
ui
Package ui implements a local web dashboard for monitoring and controlling cloop.
 Package ui implements a local web dashboard for monitoring and controlling cloop.
upgrade
Package upgrade implements self-update from GitHub releases.
 Package upgrade implements self-update from GitHub releases.
verify
Package verify generates and runs AI-produced shell verification scripts after each PM task completes.
 Package verify generates and runs AI-produced shell verification scripts after each PM task completes.
version
Package version is the single place that knows which cloop build this is.
 Package version is the single place that knows which cloop build this is.
viz
Package viz renders task dependency graphs in multiple formats.
 Package viz renders task dependency graphs in multiple formats.
voice
Package voice provides NLP intent parsing for voice-based task management.
 Package voice provides NLP intent parsing for voice-based task management.
watchdog
Package watchdog maintains the registry of per-task context cancel functions used to abort in-flight PM tasks on demand.
 Package watchdog maintains the registry of per-task context cancel functions used to abort in-flight PM tasks on demand.
webhook
Package webhook provides an event-driven HTTP notification client for cloop.
 Package webhook provides an event-driven HTTP notification client for cloop.
whatif
Package whatif implements scenario-based what-if planning for cloop.
 Package whatif implements scenario-based what-if planning for cloop.
wizard
Package wizard implements a step-by-step terminal setup wizard for cloop init.
 Package wizard implements a step-by-step terminal setup wizard for cloop init.
workspace
Package workspace manages multiple cloop projects registered in a global registry.
 Package workspace manages multiple cloop projects registered in a global registry.
worktree
Package worktree manages git worktrees for isolating parallel task execution.
 Package worktree manages git worktrees for isolating parallel task execution.
writeback
Package writeback lands the work product of an isolated executor in the project's repository on the hub.
 Package writeback lands the work product of an isolated executor in the project's repository on the hub.
tests
security
Package security is an executable specification of cloop's threat model.
 Package security is an executable specification of cloop's threat model.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.