cloop

command module
v0.0.6 Latest Latest
Warning

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

 Go to latest Published: Oct 16, 2026 License: MIT Imports: 5 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. A walkthrough of the dashboard does the same ground in a browser, in screenshots: where work is allowed to run, a project pinned there, and the plan it runs.

Requirements
  • Go 1.26+ 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, and a screenshot walkthrough of it
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.

Developers on such a hub sign their terminal in from the browser they already use — cloop login https://cloop.example.com prints a code to approve there — and then work with its projects from the shell: cloop remote for tasks, runs and live logs, cloop task attach for a shell in a running task's sandbox. See working from a terminal.

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 lint           # staticcheck (SA), unused and ineffassign, as CI's Lint job runs them
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
cmd
cloop-forward command
Command cloop-forward is the device forwarder as a standalone binary: it dials a cloop hub and bridges exactly one configured USB device or network interface, and does nothing else (Task 20429).
 Command cloop-forward is the device forwarder as a standalone binary: it dials a cloop hub and bridges exactly one configured USB device or network interface, and does nothing else (Task 20429).
internal
cosigntest
Package cosigntest stands in for cosign in tests that need its verdict to depend on *who* signed, not merely on whether verification was asked for.
 Package cosigntest stands in for cosign in tests that need its verdict to depend on *who* signed, not merely on whether verification was asked for.
dbtemplate
Package dbtemplate builds a database file once per test binary and hands each test its own copy, so that a suite does not pay to build the same database over and over.
 Package dbtemplate builds a database file once per test binary and hands each test its own copy, so that a suite does not pay to build the same database over and over.
drivertest
Package drivertest stands in for what the executor drivers talk to — a container runtime's CLI and a Kubernetes API server — so a test can drive the real drivers end to end (Task 20403): the container driver's staged lease files on disk, and the Kubernetes driver's lease Secret in the stand-in API server, are what a revocation has to reach.
 Package drivertest stands in for what the executor drivers talk to — a container runtime's CLI and a Kubernetes API server — so a test can drive the real drivers end to end (Task 20403): the container driver's staged lease files on disk, and the Kubernetes driver's lease Secret in the stand-in API server, are what a revocation has to reach.
edgetest
Package edgetest stages what an edge-channel upgrade touches, for tests (Task 20376): a device installed as `cloop executor agent install` would install it — unit, drop-ins, remote-upgrade helper, binary — under a temp directory, and an edge release served over HTTP whose assets a stand-in cosign (internal/cosigntest) will accept or refuse by signer.
 Package edgetest stages what an edge-channel upgrade touches, for tests (Task 20376): a device installed as `cloop executor agent install` would install it — unit, drop-ins, remote-upgrade helper, binary — under a temp directory, and an edge release served over HTTP whose assets a stand-in cosign (internal/cosigntest) will accept or refuse by signer.
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.
rbactest
Package rbactest holds the ui.oidc shapes every RBAC reporter is tested against (Task 20395): `cloop hub doctor`, the Settings panel, /api/me and the startup log each have to give authz.Enforced's answer for the same five blocks, and leave :8888's access exactly as it was.
 Package rbactest holds the ui.oidc shapes every RBAC reporter is tested against (Task 20395): `cloop hub doctor`, the Settings panel, /api/me and the startup log each have to give authz.Enforced's answer for the same five blocks, and leave :8888's access exactly as it was.
ssohubtest
Package ssohubtest runs a hub with single sign-on in a test's own process, for tests of the terminal commands that talk to one (Task 20417).
 Package ssohubtest runs a hub with single sign-on in a test's own process, for tests of the terminal commands that talk to one (Task 20417).
statedbtest
Package statedbtest gives tests a fully migrated, empty state.db without migrating one.
 Package statedbtest gives tests a fully migrated, empty state.db without migrating one.
taskfill
Package taskfill builds a pm.Task with every exported field set, for tests that must notice when a store drops one (Task 20361).
 Package taskfill builds a pm.Task with every exported field set, for tests that must notice when a store drops one (Task 20361).
termquery
Package termquery keeps cloop from questioning the terminal as it starts (Task 20374).
 Package termquery keeps cloop from questioning the terminal as it starts (Task 20374).
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.
apidoc
Package apidoc renders a description of an HTTP surface from the route table that serves it (Task 20257).
 Package apidoc renders a description of an HTTP surface from the route table that serves it (Task 20257).
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.
approvalnotify
Package approvalnotify tells the people who can decide a grant request or approve an API token that one is waiting on them (Task 20427).
 Package approvalnotify tells the people who can decide a grant request or approve an API token that one is waiting on them (Task 20427).
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).
attachments
Package attachments keeps the files attached to a task (Task 20428).
 Package attachments keeps the files attached to a task (Task 20428).
audit
Package audit implements security and compliance scanning for cloop projects.
 Package audit implements security and compliance scanning for cloop projects.
auditaction
Package auditaction is the registry of every action name the hub can write into the `event_type` column of `audit_events`.
 Package auditaction is the registry of every action name the hub can write into the `event_type` column of `audit_events`.
auditcheckpoint
Package auditcheckpoint writes the head of every audit chain somewhere the database cannot reach, and checks a chain against what was written (Task 20404).
 Package auditcheckpoint writes the head of every audit chain somewhere the database cannot reach, and checks a chain against what was written (Task 20404).
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).
auditforward
Package auditforward ships the audit trail off the hub as it is written (Task 20426).
 Package auditforward ships the audit trail off the hub as it is written (Task 20426).
auditmerge
Package auditmerge reads the audit trail as one thing (Task 20292).
 Package auditmerge reads the audit trail as one thing (Task 20292).
auditretention
Package auditretention seals and prunes the audit trail (Task 20218).
 Package auditretention seals and prunes the audit trail (Task 20218).
authz
audience.go is the gate half of this package.
 audience.go is the gate half of this package.
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.
caps
Package caps keeps a cloop process's Linux capabilities where they belong: with the process itself, and with the one program it starts that needs one.
 Package caps keeps a cloop process's Linux capabilities where they belong: with the process itself, and with the one program it starts that needs one.
celmatch
Package celmatch evaluates a strict subset of CEL against a claim set.
 Package celmatch evaluates a strict subset of CEL against a claim set.
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.
ciauth
Package ciauth federates a CI/CD pipeline's OIDC identity into a cloop session, without the pipeline ever holding a long-lived cloop credential.
 Package ciauth federates a CI/CD pipeline's OIDC identity into a cloop session, without the pipeline ever holding a long-lived cloop credential.
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.
claudeproxy
Package claudeproxy relays a CI/CD pipeline's Anthropic API calls through the hub, so the pipeline can run an agent harness without ever holding the hub's Claude credential.
 Package claudeproxy relays a CI/CD pipeline's Anthropic API calls through the hub, so the pipeline can run an agent harness without ever holding the hub's Claude credential.
clijson
Package clijson frames a machine-readable JSON payload so it survives a transport that also carries human-readable diagnostics.
 Package clijson frames a machine-readable JSON payload so it survives a transport that also carries human-readable diagnostics.
cloudmeta
Package cloudmeta is the one table of cloud metadata services, and the one rule for an allow list that contains one (Task 20397).
 Package cloudmeta is the one table of cloud metadata services, and the one rule for an allow list that contains one (Task 20397).
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.
deviceforward
diagnosis
Package diagnosis provides AI-powered failure analysis for PM tasks.
 Package diagnosis provides AI-powered failure analysis for PM tasks.
diskreserve
Package diskreserve holds back a little of a project's disk for the writes that record what a run did (Task 20381).
 Package diskreserve holds back a little of a project's disk for the writes that record what a run did (Task 20381).
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.
donecheck
Package donecheck is the git half of "done means committed" (Task 20370): what did one attempt at a task change in its repository and leave behind uncommitted — or commit without pushing?
 Package donecheck is the git half of "done means committed" (Task 20370): what did one attempt at a task change in its repository and leave behind uncommitted — or commit without pushing?
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
branchbundle.go describes how one git branch travels into a sandbox with a Spec (Task 20367).
 branchbundle.go describes how one git branch travels into a sandbox with a Spec (Task 20367).
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/autoupdate
Package autoupdate decides which devices in the fleet should be rolled forward, and when (Task 20331).
 Package autoupdate decides which devices in the fleet should be rolled forward, and when (Task 20331).
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/featurehub
Package featurehub is the hub's half of running a feature on an executor that isolates from the hub's filesystem (Task 20367).
 Package featurehub is the hub's half of running a feature on an executor that isolates from the hub's filesystem (Task 20367).
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/diskwatch
Package diskwatch measures a sandbox's workspace and holds a running workload to its disk limit by sampling it (Task 20405).
 Package diskwatch measures a sandbox's workspace and holds a running workload to its disk limit by sampling it (Task 20405).
executor/internal/gitforge
Package gitforge stands up a real, hermetic git remote for tests.
 Package gitforge stands up a real, hermetic git remote for tests.
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/internal/ptyshell
Package ptyshell runs a command attached to a pseudo-terminal.
 Package ptyshell runs a command attached to a pseudo-terminal.
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/projectseed
Package projectseed carries a cloop project into a sandbox that had to fetch its own source tree.
 Package projectseed carries a cloop project into a sandbox that had to fetch its own source tree.
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
harness.go answers one question about a dispatch: once `cloop run` is going on the far side, will the binary it execs be there.
 harness.go answers one question about a dispatch: once `cloop run` is going on the far side, will the binary it execs be there.
executor/resultframe
Package resultframe carries a seeded run's project result out of a sandbox whose only channel home is its own output stream (Task 20402).
 Package resultframe carries a seeded run's project result out of a sandbox whose only channel home is its own output stream (Task 20402).
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.
exposure
Package exposure decides which address `cloop ui` listens on, and refuses the one combination that turns a hub into an open door: no sign-in, and a listener the network can reach (Task 20393).
 Package exposure decides which address `cloop ui` listens on, and refuses the one combination that turns a hub into an open door: no sign-in, and a listener the network can reach (Task 20393).
feature
Package feature models parallel feature development inside one cloop project (Task 20341).
 Package feature models parallel feature development inside one cloop project (Task 20341).
featureops
Package featureops performs the operations on features that need git or the network: creating a feature's worktree, removing it, and publishing it as a pull request (Task 20341).
 Package featureops performs the operations on features that need git or the network: creating a feature's worktree, removing it, and publishing it as a pull request (Task 20341).
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.
forgehost
Package forgehost decides which forge host a repository reference names, and whether two references name the same one (Task 20423).
 Package forgehost decides which forge host a repository reference names, and whether two references name the same one (Task 20423).
forwarderstore
Package forwarderstore backs the device-forwarder enrollment flow with SQLite, the way executorstore backs the executor-agent one.
 Package forwarderstore backs the device-forwarder enrollment flow with SQLite, the way executorstore backs the executor-agent one.
fwpolicy
Package fwpolicy decides whether one IP-layer egress firewall is contained in another, and narrows one until it is (Task 20363, re-landing Task 20319 on top of the virtual executors of Tasks 20345 and 20356).
 Package fwpolicy decides whether one IP-layer egress firewall is contained in another, and narrows one until it is (Task 20363, re-landing Task 20319 on top of the virtual executors of Tasks 20345 and 20356).
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.
gitremote
Package gitremote reads a git remote as the GitHub repository it names.
 Package gitremote reads a git remote as the GitHub repository it names.
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.
hubca
Package hubca is the hub's own certificate authority, and the short-lived certificates it issues its two credential monitors (Task 20409).
 Package hubca is the hub's own certificate authority, and the short-lived certificates it issues its two credential monitors (Task 20409).
hubclient
Package hubclient is the terminal's side of a cloop hub with single sign-on (Task 20412): where `cloop login` keeps the session it was approved for, the device-authorization client that gets one, and the handful of API calls the `cloop remote` commands and `cloop task attach` make with it.
 Package hubclient is the terminal's side of a cloop hub with single sign-on (Task 20412): where `cloop login` keeps the session it was approved for, the device-authorization client that gets one, and the handful of API calls the `cloop remote` commands and `cloop task attach` make with it.
hubcluster
Package hubcluster lets several `cloop ui` processes serve one control plane (Task 20354).
 Package hubcluster lets several `cloop ui` processes serve one control plane (Task 20354).
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.
jsonbody
Package jsonbody is how a cloop HTTP handler reads a JSON request body — the only way, in pkg/ui and pkg/apiserver alike (Task 20394).
 Package jsonbody is how a cloop HTTP handler reads a JSON request body — the only way, in pkg/ui and pkg/apiserver alike (Task 20394).
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.
keyescrow
Package keyescrow wraps the hub's root secret, CLOOP_SECRET_KEY, under a passphrase an operator keeps, so that losing .cloop/hub.env stops being the end of every sealed credential (Task 20410).
 Package keyescrow wraps the hub's root secret, CLOOP_SECRET_KEY, under a passphrase an operator keeps, so that losing .cloop/hub.env stops being the end of every sealed credential (Task 20410).
kubeexec
Package kubeexec runs a kubeconfig's exec credential plugin on the developer's own machine and reads back the credential it prints, the way kubectl does (Task 20416).
 Package kubeexec runs a kubeconfig's exec credential plugin on the developer's own machine and reads back the credential it prints, the way kubectl does (Task 20416).
kubeguard
Package kubeguard is the monitor that sits between a sandbox and a Kubernetes cluster (Task 20277).
 Package kubeguard is the monitor that sits between a sandbox and a Kubernetes cluster (Task 20277).
kubeshare
Package kubeshare is a Kubernetes cluster shared with a cloop hub through a least-privilege ServiceAccount (Task 20416).
 Package kubeshare is a Kubernetes cluster shared with a cloop hub through a least-privilege ServiceAccount (Task 20416).
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 upgrades and repairs a project's .cloop directory.
 Package migrate upgrades and repairs a project's .cloop directory.
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.
offboard
Package offboard answers one question in one operation: "this person left, are they out?" (Task 20261).
 Package offboard answers one question in one operation: "this person left, are they out?" (Task 20261).
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
Persistence policy for the orchestrator's state writes (Task 20362, which re-lands Task 20295 on the orchestrator as it now is).
 Persistence policy for the orchestrator's state writes (Task 20362, which re-lands Task 20295 on the orchestrator as it now is).
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.
pausereason
Package pausereason gives a paused run a machine-readable explanation.
 Package pausereason gives a paused run a machine-readable explanation.
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.
projectconfine
Package projectconfine decides which directories may be a hub project (Task 20418).
 Package projectconfine decides which directories may be a hub project (Task 20418).
projectmember
Package projectmember is the durable per-project member list: who besides a project's owner may reach it, and at what role (Task 20366).
 Package projectmember is the durable per-project member list: who besides a project's owner may reach it, and at what role (Task 20366).
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.
provenance
Package provenance verifies that a release artifact was built and signed by cloop's own release workflow, rather than merely arriving intact.
 Package provenance verifies that a release artifact was built and signed by cloop's own release workflow, rather than merely arriving intact.
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.
provision
Package provision is what SCIM provisioning means to the hub (Task 20415): which hub identity a provisioned user is, what deactivating one severs, what reactivating one restores, what deleting one destroys, and what a provisioned group grants.
 Package provision is what SCIM provisioning means to the hub (Task 20415): which hub identity a provisioned user is, what deactivating one severs, what reactivating one restores, what deleting one destroys, and what a provisioned group grants.
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_backoff.go decides how long to stay away from the Claude Code subscription usage API after a failed fetch.
 Package ratelimit - claude_backoff.go decides how long to stay away from the Claude Code subscription usage API after a failed fetch.
recipe
Package recipe implements a named, shareable workflow library for cloop.
 Package recipe implements a named, shareable workflow library for cloop.
redact
Package redact removes known secret values from text on its way somewhere that keeps it.
 Package redact removes known secret values from text on its way somewhere that keeps it.
redact/redacttest
Package redacttest is the credential corpus every pattern scanner in cloop is held to: realistic credentials in the context they leak in, and ordinary output that has to come through untouched.
 Package redacttest is the credential corpus every pattern scanner in cloop is held to: realistic credentials in the context they leak in, and ordinary output that has to come through untouched.
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.
reviewgate
Package reviewgate is the review gate (Task 20357): an optional reviewer model, configured per project and free to differ from the model that does the work, that checks each task's changes before cloop lets them leave the working copy.
 Package reviewgate is the review gate (Task 20357): an optional reviewer model, configured per project and free to differ from the model that does the work, that checks each task's changes before cloop lets them leave the working copy.
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.
rolestore
Package rolestore is the statedb-backed authz.RuntimeSource: the layer of role bindings an operator writes during an incident, as opposed to the layer deployed in .cloop/config.yaml (Task 20248).
 Package rolestore is the statedb-backed authz.RuntimeSource: the layer of role bindings an operator writes during an incident, as opposed to the layer deployed in .cloop/config.yaml (Task 20248).
rootkey
Package rootkey resolves the hub's root secret — CLOOP_SECRET_KEY, and during a change of root the key it replaces — from the one place every reader asks (Task 20425).
 Package rootkey resolves the hub's root secret — CLOOP_SECRET_KEY, and during a change of root the key it replaces — from the one place every reader asks (Task 20425).
router
Package router maps task roles to specific AI providers.
 Package router maps task roles to specific AI providers.
runbuild
Package runbuild is what a long-lived `cloop run` knows about its own build, and what lets it move to a newer one without ending (Task 20389).
 Package runbuild is what a long-lived `cloop run` knows about its own build, and what lets it move to a newer one without ending (Task 20389).
runprobe
Package runprobe answers, for a process that is not a hub, whether a run of a project is executing (Task 20374).
 Package runprobe answers, for a process that is not a hub, whether a run of a project is executing (Task 20374).
sameorigin
Package sameorigin decides whether a request to a cloop hub was made by one of the hub's own pages, and what the request says about where it came from (Task 20394).
 Package sameorigin decides whether a request to a cloop hub was made by one of the hub's own pages, and what the request says about where it came from (Task 20394).
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.
scim
Package scim is the wire protocol of SCIM 2.0 (RFC 7643 and RFC 7644) as the hub speaks it to an identity provider (Task 20415): the resource documents, the filter and attribute-path grammars, PATCH, list responses, errors and the three discovery documents.
 Package scim is the wire protocol of SCIM 2.0 (RFC 7643 and RFC 7644) as the hub speaks it to an identity provider (Task 20415): the resource documents, the filter and attribute-path grammars, PATCH, list responses, errors and the three discovery documents.
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.
secretbroker/secretbrokertest
Package secretbrokertest provides fakes for testing code that leases GitHub App credentials through pkg/secretbroker: an in-memory store, a GitHub App API whose clock a test drives, a git forge that honours only the tokens that API minted and has not expired or revoked, and an HTTPS CONNECT proxy that lets a workload reach that forge under the name github.com.
 Package secretbrokertest provides fakes for testing code that leases GitHub App credentials through pkg/secretbroker: an in-memory store, a GitHub App API whose clock a test drives, a git forge that honours only the tokens that API minted and has not expired or revoked, and an HTTPS CONNECT proxy that lets a workload reach that forge under the name github.com.
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.
sessionrecord
Package sessionrecord records the hub's proxy sessions durably (Task 20383): the git proxy's lease-path and workspace sessions, the Kubernetes monitor's sessions and every run's egress session, in statedb's proxy_sessions (migrations/0058_proxy_sessions.sql), so the hub process that adopts a run after the one serving it stops can restore them; and the CI relay's sessions, in ci_sessions (migrations/0060_ci_sessions.sql, Task 20390), so the hub process that receives a job's next call after the one serving it stops can restore the job's session.
 Package sessionrecord records the hub's proxy sessions durably (Task 20383): the git proxy's lease-path and workspace sessions, the Kubernetes monitor's sessions and every run's egress session, in statedb's proxy_sessions (migrations/0058_proxy_sessions.sql), so the hub process that adopts a run after the one serving it stops can restore them; and the CI relay's sessions, in ci_sessions (migrations/0060_ci_sessions.sql, Task 20390), so the hub process that receives a job's next call after the one serving it stops can restore the job's session.
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
autoupdate.go stores the fleet's auto-update policy: whether the control plane rolls its executors forward on its own, which release they converge on, and how many move at once (Task 20331).
 autoupdate.go stores the fleet's auto-update policy: whether the control plane rolls its executors forward on its own, which release they converge on, and how many move at once (Task 20331).
statictoken
Package statictoken holds what the hub, the CLI and `cloop hub doctor` must agree on about the static admin token (Task 20406): how it is named without being stored, and when retiring it would leave a hub with no way in.
 Package statictoken holds what the hub, the CLI and `cloop hub doctor` must agree on about the static admin token (Task 20406): how it is named without being stored, and when retiring it would leave a hub with no way in.
stt
Package stt provides speech-to-text transcription.
 Package stt provides speech-to-text transcription.
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.
telemetry
Package telemetry is the model for browser-side diagnostic events that the hub collects so a front-end defect can be debugged from the outside (Task 20251).
 Package telemetry is the model for browser-side diagnostic events that the hub collects so a front-end defect can be debugged from the outside (Task 20251).
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 - claude_identity.go resolves which Claude Code account a request acts on, and hands the answer to both the auth endpoints and the run dispatcher.
 Package ui - claude_identity.go resolves which Claude Code account a request acts on, and hands the answer to both the auth endpoints and the run dispatcher.
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
kube/forge command
Command forge serves pkg/secretbroker/secretbrokertest's git forge over TLS, for the Kubernetes end-to-end test (tests/kube, Task 20385).
 Command forge serves pkg/secretbroker/secretbrokertest's git forge over TLS, for the Kubernetes end-to-end test (tests/kube, Task 20385).
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.