@midhunxavier/code-flow 0.0.0-stage → 0.1.0-preview.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +141 -2
- package/bin/codeflow.mjs +8 -0
- package/bin/launcher.mjs +127 -0
- package/dist/remote-host.json +1 -0
- package/licenses/inter.txt +92 -0
- package/licenses/preact.txt +21 -0
- package/licenses/signals-core.txt +21 -0
- package/licenses/signals.txt +21 -0
- package/licenses/typescript-notices.txt +193 -0
- package/licenses/typescript.txt +55 -0
- package/licenses/uqr.txt +22 -0
- package/licenses/xterm-fit.txt +19 -0
- package/licenses/xterm.txt +21 -0
- package/package.json +34 -4
- package/public/assets/changes-62ZIEQSN.js +1 -0
- package/public/assets/chunk-2PZVOKID.js +1 -0
- package/public/assets/chunk-4D5IENEB.js +1 -0
- package/public/assets/chunk-5SARP5MU.js +1 -0
- package/public/assets/chunk-63YLZ3PR.js +1 -0
- package/public/assets/chunk-7FUHKF2M.js +1 -0
- package/public/assets/chunk-APQEVJ2K.js +1 -0
- package/public/assets/chunk-CGOZQMEZ.js +2 -0
- package/public/assets/chunk-J4VYS3KV.js +2 -0
- package/public/assets/chunk-L7TUCIYF.js +1 -0
- package/public/assets/chunk-SIHDWM2Y.js +154 -0
- package/public/assets/chunk-TEJVYIKC.js +1 -0
- package/public/assets/code-browser-VB2HGZSG.js +4 -0
- package/public/assets/filtered-tasks-ES5CP4KV.js +1 -0
- package/public/assets/interactive-browser-7F5ZXRUV.js +7 -0
- package/public/assets/join-project-6RTFHNCA.js +1 -0
- package/public/assets/main-65EW73SB.js +1 -0
- package/public/assets/project-invitations-view-GMPWGWYM.js +1 -0
- package/public/assets/settings-UB5Q4AQM.js +9 -0
- package/public/assets/styles-18792BB4.css +32 -0
- package/public/assets/team-server-wizard-2GLDWS6D.js +8 -0
- package/public/assets/terminal-IWAIM4DE.js +62 -0
- package/public/assets.json +1 -0
- package/public/bundle-meta.json +1 -0
- package/public/docs/.nojekyll +0 -0
- package/public/docs/accessibility.html +19 -0
- package/public/docs/acp-agents.html +117 -0
- package/public/docs/agent-containers.html +79 -0
- package/public/docs/api.html +1130 -0
- package/public/docs/app.js +342 -0
- package/public/docs/application-improvements.html +275 -0
- package/public/docs/architecture-explorer.html +19 -0
- package/public/docs/architecture.html +149 -0
- package/public/docs/auto-team.html +148 -0
- package/public/docs/automations.html +109 -0
- package/public/docs/checkpoint-review.html +37 -0
- package/public/docs/code-hosts.html +35 -0
- package/public/docs/code-intelligence.html +35 -0
- package/public/docs/configuration.html +346 -0
- package/public/docs/context-inspection.html +23 -0
- package/public/docs/coordinated-changes.html +28 -0
- package/public/docs/deferred-runs.html +25 -0
- package/public/docs/dependency-discovery.html +19 -0
- package/public/docs/documentation.html +84 -0
- package/public/docs/dynamic-teams-evaluation.html +174 -0
- package/public/docs/dynamic-teams-implementation-plan.html +882 -0
- package/public/docs/dynamic-teams-implementation-review-1.html +141 -0
- package/public/docs/dynamic-teams-plan-review-0.html +204 -0
- package/public/docs/extensions.html +42 -0
- package/public/docs/external-sources.html +96 -0
- package/public/docs/filesystem-policy.html +26 -0
- package/public/docs/filtered-tasks.html +44 -0
- package/public/docs/font-license.txt +92 -0
- package/public/docs/getting-started.html +143 -0
- package/public/docs/github-review-threads.html +26 -0
- package/public/docs/github.html +157 -0
- package/public/docs/help.html +69 -0
- package/public/docs/index.html +88 -0
- package/public/docs/installation.html +80 -0
- package/public/docs/launch-profiles.html +48 -0
- package/public/docs/maintenance.html +60 -0
- package/public/docs/memory-claims.html +31 -0
- package/public/docs/memory-storage.html +58 -0
- package/public/docs/notifications.html +39 -0
- package/public/docs/patterns.html +195 -0
- package/public/docs/performance-results.html +210 -0
- package/public/docs/performance.html +166 -0
- package/public/docs/project-conventions.html +22 -0
- package/public/docs/project-first-navigation-plan.html +587 -0
- package/public/docs/project-teams-implementation-plan.html +772 -0
- package/public/docs/project-teams.html +129 -0
- package/public/docs/provider-compatibility.html +20 -0
- package/public/docs/releasing.html +65 -0
- package/public/docs/remote-workers.html +64 -0
- package/public/docs/review-inbox.html +26 -0
- package/public/docs/run-storage.html +23 -0
- package/public/docs/runs.html +141 -0
- package/public/docs/search.json +1 -0
- package/public/docs/security.html +133 -0
- package/public/docs/shared-projects.html +31 -0
- package/public/docs/ssh-projects.html +60 -0
- package/public/docs/style.css +768 -0
- package/public/docs/task-reruns.html +30 -0
- package/public/docs/team-collaboration.html +412 -0
- package/public/docs/verification.html +22 -0
- package/public/docs/vscode.html +53 -0
- package/public/docs/worker-permission-verification.html +131 -0
- package/public/index.html +17 -0
- package/scripts/check-node.mjs +7 -0
- package/scripts/codeflow.mjs +55 -0
- package/scripts/computer-use.swift +64 -0
- package/scripts/pty.py +273 -0
- package/src/acp-connections.js +110 -0
- package/src/adapters/acp-presets.js +37 -0
- package/src/adapters/acp-types.js +0 -0
- package/src/adapters/acp.js +328 -0
- package/src/adapters/agent-tools.js +28 -0
- package/src/adapters/agy-auth.js +67 -0
- package/src/adapters/agy-isolation.js +242 -0
- package/src/adapters/agy-tools.js +45 -0
- package/src/adapters/agy.js +326 -0
- package/src/adapters/claude-stream.js +58 -0
- package/src/adapters/claude.js +282 -0
- package/src/adapters/codex-app-server.js +555 -0
- package/src/adapters/codex.js +311 -0
- package/src/adapters/errors.js +57 -0
- package/src/adapters/index.js +91 -0
- package/src/adapters/managed-permissions.js +37 -0
- package/src/adapters/model-discovery.js +100 -0
- package/src/adapters/process.js +433 -0
- package/src/adapters/team-tools.js +103 -0
- package/src/adapters/types.js +0 -0
- package/src/agent-browser.js +688 -0
- package/src/agent-computer.js +88 -0
- package/src/agent-container.js +155 -0
- package/src/agent-team-definitions.js +131 -0
- package/src/agent-tool-client.mjs +79 -0
- package/src/agent-tools.js +296 -0
- package/src/approvals.js +134 -0
- package/src/architecture.js +456 -0
- package/src/assets.js +44 -0
- package/src/automation.js +901 -0
- package/src/browser-files.js +293 -0
- package/src/browser-ownership.js +150 -0
- package/src/certificate-renewal.js +75 -0
- package/src/chat-family.js +25 -0
- package/src/chat-handoff.js +87 -0
- package/src/checkpoint-review.js +72 -0
- package/src/checks.js +303 -0
- package/src/code-host-git.js +102 -0
- package/src/code-hosts-api.js +99 -0
- package/src/code-hosts.js +482 -0
- package/src/code-intelligence-worker.mjs +452 -0
- package/src/code-intelligence.js +141 -0
- package/src/collab/api.js +365 -0
- package/src/collab/checkpoints.js +198 -0
- package/src/collab/connections.js +139 -0
- package/src/collab/host-execution.js +347 -0
- package/src/collab/hub-client.js +210 -0
- package/src/collab/link-api.js +229 -0
- package/src/collab/link.js +595 -0
- package/src/collab/model.js +496 -0
- package/src/collab/runner.js +1014 -0
- package/src/collab/store.js +1452 -0
- package/src/collab/terminals.js +361 -0
- package/src/collaboration-reviews.js +116 -0
- package/src/config.js +48 -0
- package/src/context-budget.js +14 -0
- package/src/context-inspection.js +204 -0
- package/src/context.js +154 -0
- package/src/conventions.js +283 -0
- package/src/coordinated-api.js +247 -0
- package/src/deferred-launch.js +82 -0
- package/src/deferred-runs.js +515 -0
- package/src/dependency-health.js +35 -0
- package/src/diff.js +43 -0
- package/src/docs-help.js +316 -0
- package/src/doctor.js +232 -0
- package/src/documentation-changes.js +20 -0
- package/src/engine.js +5258 -0
- package/src/env.js +44 -0
- package/src/execution-budget.js +8 -0
- package/src/experience.js +50 -0
- package/src/extensions.js +144 -0
- package/src/filesystem-access.js +107 -0
- package/src/filesystem-policy.js +238 -0
- package/src/filtered-task-limits.js +93 -0
- package/src/filtered-tasks-api.js +53 -0
- package/src/filtered-tasks.js +576 -0
- package/src/frame-policy.js +66 -0
- package/src/fs.js +57 -0
- package/src/git.js +626 -0
- package/src/github-review-threads.js +181 -0
- package/src/github.js +538 -0
- package/src/http.js +69 -0
- package/src/improve-settings.js +38 -0
- package/src/improve.js +187 -0
- package/src/integrations.js +373 -0
- package/src/integrity.js +259 -0
- package/src/journey-api.js +77 -0
- package/src/journey-replay.js +65 -0
- package/src/journey-store.js +97 -0
- package/src/journeys.js +60 -0
- package/src/json.js +81 -0
- package/src/launch-profiles.js +292 -0
- package/src/learnings.js +80 -0
- package/src/local-app-url.js +19 -0
- package/src/log.js +39 -0
- package/src/maintenance.js +335 -0
- package/src/memory-analysis.js +182 -0
- package/src/memory-claims.js +153 -0
- package/src/memory-sqlite.js +236 -0
- package/src/memory.js +552 -0
- package/src/merge-validation.js +58 -0
- package/src/model-catalog.js +239 -0
- package/src/model-research.js +91 -0
- package/src/notes.js +176 -0
- package/src/notifications.js +413 -0
- package/src/patterns/auto-team-model.js +230 -0
- package/src/patterns/auto-team.js +816 -0
- package/src/patterns/council.js +199 -0
- package/src/patterns/debate.js +188 -0
- package/src/patterns/findings.js +141 -0
- package/src/patterns/index.js +21 -0
- package/src/patterns/loop.js +158 -0
- package/src/patterns/pipeline.js +125 -0
- package/src/patterns/prompts.js +181 -0
- package/src/patterns/race.js +147 -0
- package/src/patterns/schemas.js +40 -0
- package/src/patterns/solo.js +46 -0
- package/src/patterns/supervisor.js +235 -0
- package/src/patterns/task-draft.js +29 -0
- package/src/patterns/task-review.js +45 -0
- package/src/patterns/tdd.js +231 -0
- package/src/patterns/team-strategies.js +67 -0
- package/src/performance.js +43 -0
- package/src/persistence-status.js +35 -0
- package/src/phone-sessions.js +96 -0
- package/src/preview-overlay.js +392 -0
- package/src/preview.js +230 -0
- package/src/privacy.js +23 -0
- package/src/project-report.js +22 -0
- package/src/project-team-budget.js +22 -0
- package/src/project-team-model.js +225 -0
- package/src/project-team-policy.js +42 -0
- package/src/project-team-store.js +234 -0
- package/src/project-team-usage.js +24 -0
- package/src/project-teams-api.js +43 -0
- package/src/project-teams.js +644 -0
- package/src/projects.js +290 -0
- package/src/provider-eligibility.js +9 -0
- package/src/readiness.js +98 -0
- package/src/remote-tls.js +66 -0
- package/src/remote-workers/bundles.js +198 -0
- package/src/remote-workers/client.js +332 -0
- package/src/remote-workers/durability.js +37 -0
- package/src/remote-workers/protocol.js +68 -0
- package/src/remote-workers/stdio.js +138 -0
- package/src/remote-workers/worker.js +304 -0
- package/src/remote.js +204 -0
- package/src/repo-config.js +201 -0
- package/src/repo-coordination.js +725 -0
- package/src/repo-tree.js +106 -0
- package/src/repository-identity.js +13 -0
- package/src/retention-policy.js +466 -0
- package/src/review-inbox.js +38 -0
- package/src/routing.js +49 -0
- package/src/run-analysis.js +111 -0
- package/src/run-cold-store.js +231 -0
- package/src/run-environment.js +15 -0
- package/src/run-history.js +91 -0
- package/src/run-log.js +160 -0
- package/src/run-permissions.js +111 -0
- package/src/run-projection.js +77 -0
- package/src/run-recovery.js +53 -0
- package/src/run-status.js +56 -0
- package/src/serve.js +138 -0
- package/src/server.js +2871 -0
- package/src/shared-access.js +103 -0
- package/src/shared-accounts.js +381 -0
- package/src/shared-api.js +239 -0
- package/src/shell.js +346 -0
- package/src/ship.js +344 -0
- package/src/slots.js +74 -0
- package/src/snapshot.js +388 -0
- package/src/source-context.js +17 -0
- package/src/sse-writer.js +70 -0
- package/src/ssh-projects/bootstrap.mjs +95 -0
- package/src/ssh-projects/config.js +45 -0
- package/src/ssh-projects/gateway.js +143 -0
- package/src/ssh-projects/manager.js +320 -0
- package/src/ssh-projects/team-autostart.mjs +93 -0
- package/src/ssh-projects/team-remove.mjs +69 -0
- package/src/ssh-projects/team-status.mjs +39 -0
- package/src/ssh-projects/transport.js +133 -0
- package/src/stats.js +139 -0
- package/src/store.js +544 -0
- package/src/stream.js +91 -0
- package/src/sweeps.js +241 -0
- package/src/tailscale.js +101 -0
- package/src/task-draft.js +23 -0
- package/src/task-team.js +164 -0
- package/src/team-evaluation.js +243 -0
- package/src/team-mailbox.js +160 -0
- package/src/team-memory.js +84 -0
- package/src/team-rerun-graph.js +15 -0
- package/src/team-reruns.js +130 -0
- package/src/team-scheduler.js +121 -0
- package/src/team-steering.js +21 -0
- package/src/team-template-store.js +98 -0
- package/src/team-templates.js +117 -0
- package/src/team-tool-client.mjs +79 -0
- package/src/team-tools.js +235 -0
- package/src/teams.js +0 -0
- package/src/templates.js +62 -0
- package/src/transcript.js +134 -0
- package/src/verification-integrity.js +27 -0
- package/src/verification.js +183 -0
- package/src/watch.js +195 -0
- package/src/work-queue.js +47 -0
- package/src/workflow-control.js +83 -0
- package/src/workspace-api.js +207 -0
- package/src/workspace-changes.js +61 -0
- package/src/workspace.js +146 -0
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="description" content="Team — code-flow guides and reference"><title>Team · code-flow</title><link rel="icon" href="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgdmlld0JveD0iMCAwIDY0IDY0Ij4KICA8Y2lyY2xlIGN4PSIzMiIgY3k9IjMyIiByPSIzMCIgZmlsbD0iIzFlMWYxYSIgc3Ryb2tlPSIjM2Q0MDM2IiBzdHJva2Utd2lkdGg9IjIiLz4KICA8c3ZnIHg9IjE1IiB5PSIxNSIgd2lkdGg9IjM0IiBoZWlnaHQ9IjM0IiB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiIHN0cm9rZT0iI2VjZWJlNCIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPgogICAgPHBhdGggZD0iTTEyIDNsOSA1LTkgNS05LTV6TTMgMTNsOSA1IDktNU0zIDE3LjVsOSA1IDktNSIvPgogIDwvc3ZnPgo8L3N2Zz4K"><link rel="stylesheet" href="style.css"><script src="app.js" defer></script></head>
|
|
3
|
+
<body data-page="auto-team"><a class="skip-link" href="#content">Skip to content</a>
|
|
4
|
+
<header class="topbar"><a class="brand" href="index.html"><img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgdmlld0JveD0iMCAwIDY0IDY0Ij4KICA8Y2lyY2xlIGN4PSIzMiIgY3k9IjMyIiByPSIzMCIgZmlsbD0iIzFlMWYxYSIgc3Ryb2tlPSIjM2Q0MDM2IiBzdHJva2Utd2lkdGg9IjIiLz4KICA8c3ZnIHg9IjE1IiB5PSIxNSIgd2lkdGg9IjM0IiBoZWlnaHQ9IjM0IiB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiIHN0cm9rZT0iI2VjZWJlNCIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPgogICAgPHBhdGggZD0iTTEyIDNsOSA1LTkgNS05LTV6TTMgMTNsOSA1IDktNU0zIDE3LjVsOSA1IDktNSIvPgogIDwvc3ZnPgo8L3N2Zz4K" width="30" height="30" alt=""><strong>Code Flow</strong><span>Docs</span></a><button class="search-trigger" id="open-search">Search documentation <kbd>⌘ K</kbd></button><div class="top-actions"><a href="https://github.com/midhunxavier/code-flow">GitHub ↗</a><button id="theme" aria-label="Change color theme">Theme</button><button id="open-help" class="primary" hidden aria-expanded="false" aria-controls="help-panel">Ask code-flow</button><button id="menu" aria-label="Toggle documentation navigation" aria-expanded="false" aria-controls="sidebar">☰</button></div></header>
|
|
5
|
+
<div class="layout"><nav class="sidebar" id="sidebar" aria-label="Documentation"><section><h2>Get started</h2><a href="index.html" >Overview</a><a href="installation.html" >Install Code Flow preview</a><a href="getting-started.html" >Getting started</a><a href="patterns.html" >Team patterns</a><a href="acp-agents.html" >ACP coding agents</a><a href="help.html" >Ask code-flow</a></section><section><h2>Work with agents</h2><a href="runs.html" >Runs and workspace</a><a href="auto-team.html" aria-current="page">Team</a><a href="project-teams.html" >Project missions (preview)</a><a href="review-inbox.html" >Review inbox</a><a href="verification.html" >Verification and review</a><a href="github.html" >GitHub, review and shipping</a><a href="github-review-threads.html" >GitHub review threads</a><a href="task-reruns.html" >Selective task reruns</a><a href="deferred-runs.html" >Deferred runs</a></section><section><h2>Your workspace</h2><a href="configuration.html" >Configuration</a><a href="context-inspection.html" >Context and budgets</a><a href="project-conventions.html" >Versioned project conventions</a><a href="checkpoint-review.html" >Checkpoints and reversions</a><a href="launch-profiles.html" >Service launch profiles</a><a href="code-intelligence.html" >Code intelligence</a><a href="architecture-explorer.html" >Architecture explorer</a><a href="memory-storage.html" >Project memory</a><a href="memory-claims.html" >Semantic claim review</a><a href="coordinated-changes.html" >Coordinated changes</a></section><section><h2>Connect and collaborate</h2><a href="team-collaboration.html" >Team collaboration</a><a href="shared-projects.html" >Shared project accounts</a><a href="ssh-projects.html" >SSH projects</a><a href="remote-workers.html" >Remote agent workers</a><a href="code-hosts.html" >GitLab and Bitbucket code workflows</a><a href="external-sources.html" >Read-only external sources</a><a href="automations.html" >Automations and away mode</a><a href="notifications.html" >Outbound notifications</a></section><section><h2>Operate safely</h2><a href="security.html" >Security, subscriptions and caveats</a><a href="filesystem-policy.html" >Project filesystem policy</a><a href="agent-containers.html" >Agent containers</a><a href="filtered-tasks.html" >Filtered Docker tasks</a><a href="dependency-discovery.html" >Dependency discovery</a><a href="maintenance.html" >Backup and maintenance</a></section><section><h2>Build and extend</h2><a href="architecture.html" >Architecture and development</a><a href="api.html" >Local API and command-line client</a><a href="extensions.html" >Provider and workflow extensions</a><a href="provider-compatibility.html" >Provider compatibility</a><a href="accessibility.html" >Accessibility acceptance</a><a href="performance.html" >Performance</a><a href="run-storage.html" >Run storage</a><a href="documentation.html" >Documentation and GitHub Pages</a><a href="releasing.html" >Preparing a preview release</a><a href="vscode.html" >Code Flow for VS Code</a></section><section><h2>Engineering records</h2><a href="application-improvements.html" >Application improvement program</a><a href="project-first-navigation-plan.html" >Project navigation review and implementation plan</a><a href="dynamic-teams-evaluation.html" >Dynamic teams: implementation evidence and rollout decision</a><a href="dynamic-teams-implementation-plan.html" >Dynamic teams, workflows, messaging, and memory</a><a href="dynamic-teams-implementation-review-1.html" >Review 1: the dynamic teams implementation</a><a href="worker-permission-verification.html" >Live worker permission verification</a><a href="dynamic-teams-plan-review-0.html" >Review 0: Dynamic teams implementation plan</a><a href="project-teams-implementation-plan.html" >Standing project teams implementation plan</a><a href="performance-results.html" >Measured performance: 19 October 2026</a></section><a class="app-link" id="back-app" hidden href="/">← Back to app</a></nav>
|
|
6
|
+
<main id="content" tabindex="-1"><div class="breadcrumb">Documentation <span>/</span> Work with agents</div><article><h1 id="team">Team</h1>
|
|
7
|
+
<p>Start with an Agent conversation and enable <strong>Team</strong> whenever the task needs collaboration. Choose a template and providers in Team setup. You can turn Team off and continue with the same agent, task, workspace and conversation.</p>
|
|
8
|
+
<h2 id="review-the-proposed-team">Review the proposed team</h2>
|
|
9
|
+
<p>Open <strong>Team</strong>, enable it, and select the template, coordinator and providers code-flow may use. A coordinator inspects the repository and proposes individual members, tasks, dependencies, file ownership, and acceptance criteria. You can approve, revise, or reject that plan before workers start. Planning itself uses a CLI invocation. Approval defaults on; an explicitly saved preference or automation policy still applies.</p>
|
|
10
|
+
<p>Team is available unless disabled with <code>CODEFLOW_AUTO_TEAM_ENABLED=false</code>. Existing saved workflow and project choices are preserved. Simple conversational questions are answered by the lead without starting another team; explicit team requests and substantial work use the configured workflow. Team progress stays collapsed under its chat message. Corrections sent while a team works stop the current execution and enter a revised request, with a visible acknowledgement and preserved partial work. Existing manual patterns are available under Advanced as built-in workflow templates. It uses the same official CLI adapters, worktrees, checks, permissions, review/shipping actions, and subscription logins as other runs.</p>
|
|
11
|
+
<h2 id="reusable-templates-in-advanced">Reusable templates in Advanced</h2>
|
|
12
|
+
<p>Open <strong>Advanced</strong> to choose a built-in workflow, design a task graph, import/export definitions, or publish a new immutable template version. Templates can be personal or scoped to a project. Use <strong>Import browser library</strong> to migrate existing presets without deleting the browser originals; role/model preferences and workflow options survive, while permission grants, credentials, host bindings, and budgets do not.</p>
|
|
13
|
+
<p>Auto generates plans without needing a template. It may also reuse enabled task graphs, assign their roles, combine instances, and append task-specific instructions. The runtime preserves dependencies, acceptance criteria, and shared contracts, then applies normal plan validation and independent verification. Up to six enabled definitions of 16,000 characters each are offered per run, in ID order. Fixed workflows such as test-first, races, and councils keep their existing executors in Advanced; they are not advertised as composable Auto task graphs.</p>
|
|
14
|
+
<p>A manually selected template is mandatory. Its exact version and inputs are pinned to the run and survive cancellation/recovery; editing the library does not change an active run. The run menu's <strong>Save as team template…</strong> opens an editable preview. Review task-specific instructions and replace them with parameters before publishing. Saving does not enable Auto reuse automatically.</p>
|
|
15
|
+
<h2 id="run-permissions-across-providers">Run permissions across providers</h2>
|
|
16
|
+
<p>All new runs use one versioned permission policy, including background jobs and collaborative launches. Every planning, worker, review, repair, retry, and follow-up launch resolves that policy against current restrictions and the selected provider. Read-only planning does not reduce implementation workers to read-only access. Templates and agent messages cannot grant permissions; only an explicit user change creates a new policy revision. Child runs inherit the parent’s current trust ceiling, approval preference, mandatory restrictions, and container or remote execution environment. A child cannot increase its parent’s permissions or remove its execution boundary. Historical saved runs without a policy retain their legacy behavior.</p>
|
|
17
|
+
<p>Claude and Codex receive their native permission settings, with provider-native delegation disabled. Matching trust labels do not imply identical isolation: Codex uses its provider sandbox, while Claude's local tool rules are not an operating-system filesystem boundary. Advanced can require an agent workspace write boundary, denied agent-command network access, or disabled external tools. Unsupported combinations fail before launch or replacement dispatch. The run view records the effective settings for each turn. By default, Antigravity uses the local macOS isolated executor with supported CLI 1.4.4 or 1.4.5 and an existing native Keychain login. Interactive Agent and Team turns receive task-scoped Codeflow browser and computer tools when external tools are permitted; computer use requires Full access. It uses protected fresh settings, has no native terminal/browser/delegation or ambient MCP servers, and never resumes native sessions. Mandatory external-tool restrictions retain its file-only profile. Shared-tool live validation covers 1.4.5. Advanced also offers explicit unrestricted native Antigravity on the local host; see below. Remote/container Antigravity, ACP and extension adapters remain blocked. Claude/Codex controls are probed again at each launch, in the selected container when applicable. Unknown or missing controls stop execution.</p>
|
|
18
|
+
<p>Remote workers receive and validate the complete policy, including all mandatory requirements; remote/container profiles that cannot prove a requested boundary are rejected. Required interactive approvals need the local Codex app-server and an approval handler; they cannot silently fall back to exec or combine with mandatory sandbox boundaries that approval could relax.</p>
|
|
19
|
+
<p>Claude’s external-tool restriction supplies a strict MCP configuration, disables Chrome integration, and denies WebSearch/WebFetch; Code Flow’s scoped team bridge remains available. Codex managed turns override ambient approval settings, additional writable roots, and command-network settings. A mandatory workspace write boundary also removes temporary-directory write exemptions. Native-delegation controls disable provider agent tools; they are not process-level isolation from programs invoked through an authorized shell.</p>
|
|
20
|
+
<p>These requirements describe agent execution. Browser/MCP authorization is separate from terminal network access. Setup commands, checks, and previews use their separately configured execution environment. Worktrees do not restrict file reads. The built-in shared browser/computer bridge applies the same task-scoped tool checks across Claude, Codex and Antigravity. Arbitrary provider-configured integrations and filesystem reads do not share a cross-provider sandbox.</p>
|
|
21
|
+
<h2 id="how-work-proceeds">How work proceeds</h2>
|
|
22
|
+
<ol>
|
|
23
|
+
<li>The runtime validates the proposed plan against installed providers, quota observations, configured model/effort pins, member/task limits, dependency cycles, and review independence.</li>
|
|
24
|
+
<li>New runs start ready tasks as earlier tasks finish, without waiting for unrelated workers. Saved wave-based runs retain their recorded scheduling behavior. Each member has its own identity and session, even when several members use the same provider. Tasks with overlapping file ownership run separately.</li>
|
|
25
|
+
<li>A worker returns a structured outcome: submitted work, a failure, or a question with a progress checkpoint. Submitted changes are integrated serially and checked before dependent work starts.</li>
|
|
26
|
+
<li>When a decision is needed, the coordinator can add bounded work or workers, reassign unfinished work, retire idle workers, and add shared contracts. It cannot remove approved requirements or raise its own limits.</li>
|
|
27
|
+
<li>An independent read-only member reviews the integrated result. Blocking findings can trigger bounded repairs, followed by another check and review of the current commit.</li>
|
|
28
|
+
</ol>
|
|
29
|
+
<p>An implementation is verified only when required work is present, the configured check passes, independent review has no blocking findings, and fail-to-pass proof succeeds when enabled. Unresolved tasks, blocking review findings and failing checks are gaps that stop the team. A repository without a runnable check cannot be blocked on it: the result finishes as reviewed but unverified, with no pass/fail verdict, and nothing from it is accepted into team or project memory. An investigation can finish with evidence-bearing artifacts and independent review without a code check. The run does not merge or publish its result automatically.</p>
|
|
30
|
+
<h2 id="communication-and-blockers">Communication and blockers</h2>
|
|
31
|
+
<p>Members send addressed questions and replies through their structured outcomes. The runtime attaches the sender, task, request ID, and origin; an agent message never becomes user authorization. A worker needing information ends its turn, saving its partial work and checkpoint. Its CLI slot is then available for other work.</p>
|
|
32
|
+
<p>The next scheduling boundary delivers an existing answer or runs a short read-only response turn for the addressed member. A question addressed to you appears in the run view and in <strong>Needs you</strong>. Your answer is saved before the waiting workflow is released. The run clock pauses while waiting for you. An unanswered peer request or failed task can prompt a bounded coordinator revision; exhausted limits produce an explicit blocker.</p>
|
|
33
|
+
<p>You can also send a note to an individual member. Codex app-server can receive user notes during a turn; other transports receive them on the next turn. Native permission requests remain denied under the existing adapter policy. Auto members use the structured question protocol for missing information.</p>
|
|
34
|
+
<p>Claude and Codex members also receive scoped collaboration tools when their installed CLI supports the configuration. They can send messages, ask/reply, read their inbox, publish findings, save notes, or propose project memory during a turn. Calls acknowledge durable acceptance promptly; the scheduler applies commands at recorded boundaries. A blocked member still ends its turn to release the process slot. Each turn may make at most 256 collaboration tool calls (messages, questions, memory reads and writes together); after that, calls fail and the member finishes with its structured outcome. New controlled runs support Claude, Codex and isolated Antigravity. Explicit unrestricted Antigravity is an exception to the native-delegation restriction; other adapters remain rejected. Older saved runs retain their recorded execution behavior.</p>
|
|
35
|
+
<p>Question and wait state are one logical journal transaction. Duplicate operation IDs do not duplicate messages. Expired deadlines, unavailable recipients and cyclic waits route to the coordinator within the existing budget. Reassigned or retired attempts cannot overwrite current work. Knowledge dependencies can use evidence-bearing replies; artifact dependencies require integrated code, and completion dependencies require the upstream task to finish.</p>
|
|
36
|
+
<h2 id="three-memory-scopes">Three memory scopes</h2>
|
|
37
|
+
<div class="table-scroll" tabindex="0"><table>
|
|
38
|
+
<thead>
|
|
39
|
+
<tr>
|
|
40
|
+
<th>Scope</th>
|
|
41
|
+
<th>Contents</th>
|
|
42
|
+
<th>Who receives it</th>
|
|
43
|
+
</tr>
|
|
44
|
+
</thead>
|
|
45
|
+
<tbody><tr>
|
|
46
|
+
<td>Private</td>
|
|
47
|
+
<td>Observable progress, attempts, unresolved questions, and a portable checkpoint</td>
|
|
48
|
+
<td>That member; a replacement receives a separately authored shared handover and artifacts</td>
|
|
49
|
+
</tr>
|
|
50
|
+
<tr>
|
|
51
|
+
<td>Team</td>
|
|
52
|
+
<td>Accepted contracts, task outcomes, questions, findings, and artifact references</td>
|
|
53
|
+
<td>Members whose assignment needs the information; reviewers receive independent review context</td>
|
|
54
|
+
</tr>
|
|
55
|
+
<tr>
|
|
56
|
+
<td>Project</td>
|
|
57
|
+
<td>Accepted conventions and reusable facts with source, revision, and applicability</td>
|
|
58
|
+
<td>Future matching runs in the same project and repository</td>
|
|
59
|
+
</tr>
|
|
60
|
+
</tbody></table>
|
|
61
|
+
</div><p>Private scope controls context assembly and memory APIs; it is not filesystem secrecy from a fully trusted process on the same machine. Checkpoints describe observable work, not hidden model reasoning.</p>
|
|
62
|
+
<p>The team view shows members, dependencies, messages, requirement coverage, checkpoints, and each worker turn's context references. The project-memory panel shows included and omitted entries with reasons, provenance, and branch applicability. You can create, edit, accept, delete, or rate a memory as useful, irrelevant, stale or incorrect. Saving an edit never accepts a proposal: a proposal stays a proposal until you accept it, and an accepted entry you edit is recorded as accepted by you. Edits require the displayed revision, so concurrent changes cannot silently overwrite one another.</p>
|
|
63
|
+
<p>Structured worker findings become project <strong>proposals</strong> after result verification. Live tools can save an earlier proposal, explicitly unverified and requiring user review. They remain tied to the result branch and commit. Accepting a branch-specific proposal does not make it a convention for every branch; changing it to <strong>Use across this repository</strong> is an explicit user decision. Repository membership, branch/commit ancestry, expiry, and source revisions are checked when selecting memory. Retrieval uses bounded text/path/tag matching, without embeddings. User feedback adjusts ranking only for that revision; stale or incorrect revisions are excluded. Feedback never raises trust or authorizes promotion.</p>
|
|
64
|
+
<p>Locked-down, untrusted, or unknown-origin material cannot automatically become accepted project knowledge, including through a derived summary. The user must approve the exact revision. Auto teams do not consume historical recurring lessons whose provenance is missing; explicit repository conventions and accepted project memory are separate inputs. Automatic learning is also disabled for untrusted sources.</p>
|
|
65
|
+
<p>Deleting a memory erases its stored body, removes it from retrieval, and retains deletion metadata. Entries that list it in their provenance (it was in a member's context when they were written) keep their own text and the origins they inherited from it, so a running or resumed team that still cites it keeps working. Private checkpoints and team records are retired when their run is archived with cleanup; project knowledge is never removed that way. A run may hold at most 512 private and team records. Source run transcripts, task checkpoints in run history, provider conversations, and user backups have separate retention. Deleting memory does not erase those source histories or a prompt already supplied to a running CLI.</p>
|
|
66
|
+
<h2 id="budgets-restart-and-resume">Budgets, restart, and resume</h2>
|
|
67
|
+
<p>The run's maximum steps is also Auto team's actual CLI invocation ceiling; an explicit smaller <code>maxInvocations</code> lowers that ceiling for planning and scheduling too. Provider retries and schema repairs count. Up to one quarter of the invocation allowance may be coordinator calls, and the runtime reserves a turn for independent review when admitting work. New runs default to 200 calls over 240 minutes, allowing up to 50 coordinator calls. At least four invocations are required for a new team. These are bounds on authorized invocations, not a claim that coordination will always be 25% of actual usage.</p>
|
|
68
|
+
<p>When a run stops, edit <strong>Maximum calls</strong> and <strong>Maximum minutes</strong> before resuming, or choose <strong>Use extended budget</strong> for 200 calls and 240 minutes. Resume grants a fresh allocation, reuses completed results and worktrees, and retains lifetime usage. Saved runs keep their existing limits until you explicitly change them.</p>
|
|
69
|
+
<p>The team view reports lifetime invocations, coordination share, questions, blocked turns, and revisions. Provider-reported tokens and API-equivalent cost remain unknown where the provider does not report them; cost is not a subscription bill.</p>
|
|
70
|
+
<p>Launch reservations are recorded before starting a CLI. After a crash in the interval between that write and process launch, lifetime counts conservatively retain the reservation; the runtime cannot prove whether an external process started.</p>
|
|
71
|
+
<p>Accepted decisions and outcomes use the existing fsynced replay journal. A failed authoritative write stops dependent dispatch. Recovery ignores an incomplete final journal record, removes that incomplete tail before the next append, and rejects malformed complete records. Event logs remain best-effort projections. SSE reconnects across server restarts reconcile an authoritative snapshot before continuing the stream.</p>
|
|
72
|
+
<p>A blocked Auto run is <strong>stopped</strong>, with its work available and its workflow unfinished. <strong>Resume</strong> replays completed allocations, including their final review and repair steps, then grants a fresh bounded allocation. Interrupted allocations continue their recorded workflow. Lifetime usage remains visible across resumes; replayed calls do not spend again. A missing provider session falls back to a fresh session with explicit task context. As with other patterns, a CLI can perform work immediately before a crash, so recovery does not promise exactly-once external execution.</p>
|
|
73
|
+
<p>During a run, <strong>Revise goal</strong> stops the old execution, retains its branches and supplied context, then opens a linked team plan for your changed requirements. It uses a new explicit budget and the configured approval checkpoint. Ordinary member notes leave the accepted requirement set intact. Source trust and lockdown follow both forms of continuation.</p>
|
|
74
|
+
<p>After completion, <strong>Whole team · new run</strong> plans and verifies your follow-up against the result branch. The reply box exposes its new call/time allocation; direct follow-ups can use a one-call budget and also enforce an explicit launch ceiling including retries. A provider-addressed follow-up starts outside the team's private member sessions, then can continue its own conversation. A direct agent follow-up that changes the integrated result clears its previous team approval, even if its check passes. The run displays that it needs whole-team verification again.</p>
|
|
75
|
+
<h2 id="adapter-capabilities">Adapter capabilities</h2>
|
|
76
|
+
<div class="table-scroll" tabindex="0"><table>
|
|
77
|
+
<thead>
|
|
78
|
+
<tr>
|
|
79
|
+
<th>Capability in code-flow</th>
|
|
80
|
+
<th>Claude Code</th>
|
|
81
|
+
<th>Codex</th>
|
|
82
|
+
<th>Antigravity</th>
|
|
83
|
+
</tr>
|
|
84
|
+
</thead>
|
|
85
|
+
<tbody><tr>
|
|
86
|
+
<td>Structured outcomes and session continuation</td>
|
|
87
|
+
<td>Supported</td>
|
|
88
|
+
<td>Supported</td>
|
|
89
|
+
<td>Structured outcomes; fresh turns with portable context</td>
|
|
90
|
+
</tr>
|
|
91
|
+
<tr>
|
|
92
|
+
<td>Addressed questions at turn boundaries</td>
|
|
93
|
+
<td>Supported</td>
|
|
94
|
+
<td>Supported</td>
|
|
95
|
+
<td>Supported</td>
|
|
96
|
+
</tr>
|
|
97
|
+
<tr>
|
|
98
|
+
<td>User notes during a running turn</td>
|
|
99
|
+
<td>Next turn</td>
|
|
100
|
+
<td>App-server steering; next-turn fallback with exec</td>
|
|
101
|
+
<td>Next turn</td>
|
|
102
|
+
</tr>
|
|
103
|
+
<tr>
|
|
104
|
+
<td>Native permission requests</td>
|
|
105
|
+
<td>Existing allowlist policy</td>
|
|
106
|
+
<td>Declined</td>
|
|
107
|
+
<td>Protected file-only policy; no interactive approvals</td>
|
|
108
|
+
</tr>
|
|
109
|
+
<tr>
|
|
110
|
+
<td>Agent-accessible collaboration tools</td>
|
|
111
|
+
<td>Scoped per-turn MCP and allowlist; <code>--strict-mcp-config</code>, so your own and the repository's MCP servers are not loaded in these turns</td>
|
|
112
|
+
<td>Scoped per-turn MCP, app-server and exec</td>
|
|
113
|
+
<td>Structured-outcome fallback</td>
|
|
114
|
+
</tr>
|
|
115
|
+
</tbody></table>
|
|
116
|
+
</div><p>The capabilities panel distinguishes tested, unsupported and unknown behavior using adapter protocol fixtures and installed CLI probes. Inventory probe results are kept for ten minutes; an unknown result (a CLI missing or not signed in, or a probe that timed out) is kept for two, while managed launch controls are checked afresh before each turn. Model behavior is measured separately. Native Claude and Codex agent-spawning tools are disabled for scoped team turns so code-flow retains ownership of the roster. Default Antigravity uses a protected file-tool allowlist and macOS process/filesystem restrictions; native delegation is excluded. The explicit unrestricted option does not enforce these restrictions. Its built-in local task bookkeeping tool can remain visible. Separate vendor-native token accounting remains unknown.</p>
|
|
117
|
+
<p>The live bridge binds a random loopback port and issues an expiring credential for one active member attempt. Credentials are stored in temporary files with mode 0600 and removed when the turn exits; they are absent from prompts, command-line arguments, run records and logs. The path of the credential file is on the command line, and every CLI on this machine runs as your user: a member that can run shell commands could read another member's credential while that turn is starting. The bridge client deletes the file as soon as it has read it, which narrows the window to process start; this is isolation between members and the application's own token, not between members. The engine derives identity and provenance. A read-only reviewer can communicate without receiving source-write permissions; sandbox/network restrictions are not relaxed to enable collaboration.</p>
|
|
118
|
+
<h2 id="implementation-and-evaluation">Implementation and evaluation</h2>
|
|
119
|
+
<p>The implementation uses <code>src/teams.ts</code>, <code>src/patterns/auto-team-model.ts</code>, and <code>src/patterns/auto-team.ts</code>, with engine metadata and replay helpers. <code>src/memory.ts</code> applies versioned memory rules over <code>src/memory-sqlite.ts</code>; <code>src/team-memory.ts</code> applies run provenance and Git/project applicability. Structured memory uses SQLite with automatic JSON migration and evidence-linked graph retrieval. Node 22.13 or newer is required; no native npm addon is needed. See <a href="memory-storage.html">Memory storage</a>.</p>
|
|
120
|
+
<p>Tests use fake vendor CLIs and isolated repositories. They exercise plan validation/approval, same-provider identities, dependency waves, peer and user questions, restart/resume, member replacement, independent verification, storage failures, memory trust/revision/deletion, and the browser workflow. They demonstrate behavior, not model quality or subscription savings. <code>npm run evaluate:teams -- --fake</code> runs an isolated comparison without model calls. Use <code>--real --runs 1 --providers claude,codex --max-steps 12 --max-minutes 5 --out /absolute/output</code> for a bounded comparison through signed-in CLIs. Reports record mode, CLI versions, actual calls, coverage, coordinator overhead, peer waiting and journal-load size/time. Estimated avoidable barrier delay is labeled separately from observed waiting.</p>
|
|
121
|
+
<p>Insights shows evaluations and the recorded rollout decision. Fake or unknown runs cannot justify beta/default promotion. Promotion beyond the experimental stage requires the documented evidence thresholds; default rollout requires a larger representative sample. See <a href="dynamic-teams-evaluation.html">implementation evidence</a>.</p>
|
|
122
|
+
<p>Set <code>CODEFLOW_AUTO_TEAM_ENABLED=false</code> to disable creation of new Auto runs. Existing teams remain inspectable and resumable; manual patterns and saved automations retain their compatibility. The feature does not require a database or new Node baseline.</p>
|
|
123
|
+
<p>The evaluation runner also accepts <code>--register-home /absolute/codeflow-home</code> to copy immutable reports into a chosen installation for Insights. This is explicit: it does not copy transcripts or change rollout settings. Reports are also available in the isolated evaluation home's <code>team-evaluations/</code> folder.</p>
|
|
124
|
+
<hr>
|
|
125
|
+
<p><a href="index.html">Documentation library</a> · <a href="getting-started.html">Getting started</a> · <a href="help.html">Ask code-flow</a></p>
|
|
126
|
+
<h2 id="automatic-worker-models">Automatic worker models</h2>
|
|
127
|
+
<p>New Auto runs discover candidates through the connected CLI: Claude's stream-control initialization, Codex app-server <code>model/list</code>, and Antigravity <code>agy models</code>. The coordinator keeps the provider, model and effort selected by the user, including existing CLI defaults. Workers and reviewers use automatic selection unless their Advanced pool/model/effort settings pin or restrict them. Global coordinator defaults do not silently pin workers.</p>
|
|
128
|
+
<p>Advanced → Automatic worker selection shows cached model IDs, exact effort support, stale/unknown states and refresh. Official-document research is opt-in. Local catalog previews do not establish remote/container availability: those environments discover their own models when a run starts. Antigravity worker discovery runs inside the same macOS executor with a separate catalog identity. Its model listings do not establish per-model inference or effort support. The coordinator sees the effective file and task-tool capabilities and rejects unsupported execution environments. Every launch rechecks the CLI version and creates a clean protected profile. See <a href="worker-permission-verification.html#existing-login-reuse-and-managed-file-workers">permission verification</a>.</p>
|
|
129
|
+
<p>Catalogs live under <code>CODEFLOW_HOME/model-catalogs</code>, partitioned by provider and execution environment. Discovery has a ten-minute cache; failed refreshes retain previous evidence. <code>CODEFLOW_MODEL_NETWORK=offline</code> disables discovery and documentation fetches and uses cached entries. This switch does not disable provider inference or the run's separately configured tools. Documentation research uses official origins, bounded downloads and a closed schema, with a seven-day attempt cache. Web text cannot grant permissions or prove account access. Unknown context, pricing, capabilities and effort support remain unknown; an explicit empty effort list means no effort control.</p>
|
|
130
|
+
<p>CLI-reported availability, advertised compatibility, documented facts and measured run observations are distinct. A listed model is a candidate, not a guarantee that a paid inference call will succeed. Exact accepted worker choices, rationale, environment and catalog revision/source are saved with the step; discovery revisions have immutable snapshots. Recovery reuses recorded choices and rechecks eligibility before another execution. Failed members can be replaced within existing revision/invocation limits using portable checkpoints; native sessions stay with their provider/member.</p>
|
|
131
|
+
<p>The first version uses existing routing and budget checks, not a learned performance ranker. Costs and token limits retain their existing provider-reporting limitations; unknown pricing cannot supply an exact prospective cost guarantee. Run observations are diagnostic evidence, not benchmark scores or authority to enable a model. Public documentation only augments CLI-reported IDs; it does not make a public-only model eligible.</p>
|
|
132
|
+
<p>See <a href="worker-permission-verification.html">the live permission verification report</a> for tested versions, native-control fixes and remaining boundaries.</p>
|
|
133
|
+
<p>If an isolated Antigravity worker cannot use or refresh its native login, check or unlock the login in Antigravity's normal interactive session and select <strong>Resume</strong>. Code Flow verifies it again through isolated model discovery before clearing the signed-out cooldown. Cached models or offline discovery cannot establish login access. Recovery keeps the recorded assignment and portable work, then starts a fresh restricted worker; it never imports a native conversation or widens permissions to refresh credentials. Native authentication diagnostics are withheld from run history.</p>
|
|
134
|
+
<h3 id="unrestricted-antigravity-with-an-existing-login">Unrestricted Antigravity with an existing login</h3>
|
|
135
|
+
<p>Enable <strong>Advanced → Antigravity execution → Use unrestricted Antigravity with my existing login</strong> for a new local attended run. This explicitly grants Antigravity full native access using the existing login and provider configuration. Shared Codeflow tools are added through a private temporary configuration overlay. It skips the isolated profile and vendor sandbox and uses the CLI's permission-skip flag. It requires a valid saved login; it does not provide anonymous access or guarantee that the provider will never require reauthentication.</p>
|
|
136
|
+
<p>Terminal, browser, MCP, hooks and native agents follow the native provider configuration. Code Flow cannot enforce workspace boundaries or read-only access in this mode. Native agent usage is outside Code Flow's worker budget. The selection is visible in Advanced, run details, coordinator inventory and each step's permission receipt (<code>agy-native-v1</code>). Claude and Codex keep the ordinary run policy.</p>
|
|
137
|
+
<p>The option is rejected with mandatory permission requirements, Safe mode, narrowed turn trust, interactive tool approvals, remote/container workers or unattended/locked-down execution. Templates and model choices cannot enable it. A continuation inherits the parent's choice and may narrow it to isolated execution, but cannot upgrade an isolated parent. Existing saved runs stay isolated; there is no automatic fallback on authentication or sandbox errors.</p>
|
|
138
|
+
<p>Native model discovery uses the existing profile, with a catalog identity distinct from isolated discovery. Both modes keep portable checkpoints and start fresh managed turns without native session reuse. Recovery after an authentication failure requires a fresh successful discovery in the recorded mode; cached/offline results cannot clear the failure. Private authentication diagnostics are checked for observed persistence failures and deleted without entering run history. Actual expired-token refresh remains unverified unless observed during normal provider operation.</p>
|
|
139
|
+
<h3 id="steering-and-recovery-in-a-conversation">Steering and recovery in a conversation</h3>
|
|
140
|
+
<p>Keep using the main composer while Team works. Name a worker, assignment, or owned file when correcting a specific part—for example, “For api.txt, use the revised wording.” Code Flow stops that assignment and invalidates dependent work while unrelated teammates continue. Its acknowledgement means the revised instructions reached the assignment, not that the change has passed review. Ambiguous corrections affect the whole graph. Corrections during planning or final verification safely restart the delegated execution with its preserved context and remaining budget.</p>
|
|
141
|
+
<p>The Browser panel has <strong>Take control</strong> and <strong>Let agents continue</strong>. Taking control waits for the current action to settle, then pauses queued agent browser calls. You and the agents keep the same tabs, cookies, uploads and downloads. Ordinary mouse/keyboard input briefly takes control and releases it afterward. Agents can release their browser lease through <code>browser_control</code>; idle leases expire after 30 seconds, and queued calls have a bounded 90-second wait. A new owner must inspect the current page before acting.</p>
|
|
142
|
+
<p>Team coordination, workers and review can continue with another eligible provider from the configured pool after a provider failure. The replacement receives the current assignment, files and recorded tool-action history in a fresh provider session. Model pins, tool permissions, independence requirements and the remaining budget still apply. An unavailable strict independent reviewer blocks completion when no eligible replacement exists. The advanced Auto workflow option <code>providerFailover: false</code> retains manual provider recovery. Provider changes are recorded under Team activity.</p>
|
|
143
|
+
<p>If your edits overlap a team result, open <strong>Team activity → Resolve conflicts</strong>. Compare the starting version, your version and the team version; keep either version or edit a text result. Non-overlapping edits merge automatically. Code Flow rejects stale comparisons and preserves your branch and staging area. Applying a resolution runs the configured checks, including verification-profile gates, against the combined workspace. This check does not replace independent review of newly edited text. Binary and symbolic-link conflicts require choosing an existing version; complex repository conflicts can still be resolved in an editor.</p>
|
|
144
|
+
</article><footer><a href="https://github.com/midhunxavier/code-flow/blob/main/docs/auto-team.md">Edit this page on GitHub ↗</a><span>code-flow · 0.1.0-preview.3 · <a href="font-license.txt">Font license</a></span></footer><nav class="pagination" aria-label="Adjacent guides"><a href="runs.html"><small>← Previous</small>Runs and workspace</a><a href="project-teams.html"><small>Next →</small>Project missions (preview)</a></nav></main>
|
|
145
|
+
<aside class="on-page" aria-label="On this page"><strong>On this page</strong><a class="depth-2" href="#review-the-proposed-team">Review the proposed team</a><a class="depth-2" href="#reusable-templates-in-advanced">Reusable templates in Advanced</a><a class="depth-2" href="#run-permissions-across-providers">Run permissions across providers</a><a class="depth-2" href="#how-work-proceeds">How work proceeds</a><a class="depth-2" href="#communication-and-blockers">Communication and blockers</a><a class="depth-2" href="#three-memory-scopes">Three memory scopes</a><a class="depth-2" href="#budgets-restart-and-resume">Budgets, restart, and resume</a><a class="depth-2" href="#adapter-capabilities">Adapter capabilities</a><a class="depth-2" href="#implementation-and-evaluation">Implementation and evaluation</a><a class="depth-2" href="#automatic-worker-models">Automatic worker models</a><a class="depth-3" href="#unrestricted-antigravity-with-an-existing-login">Unrestricted Antigravity with an existing login</a><a class="depth-3" href="#steering-and-recovery-in-a-conversation">Steering and recovery in a conversation</a></aside>
|
|
146
|
+
<aside id="help-panel" hidden aria-labelledby="help-title"><div class="chat-heading"><div><span class="eyebrow">Your AI companion</span><h2 id="help-title">Ask code-flow</h2></div><button id="close-help" aria-label="Close AI companion">✕</button></div><div class="chat-toolbar"><span>Grounded in your docs</span><button id="new-chat">New chat</button></div><div id="help-messages" role="log" aria-label="Help conversation" aria-live="polite"><div id="chat-welcome"><span class="chat-mark" aria-hidden="true">✦</span><h3>What would you like to do?</h3><p>Let’s find your next step. Ask about setup, workflows or something that’s unclear.</p><div class="suggestions"><button type="button" data-question="How do I start my first run?">Start my first run ↗</button><button type="button" data-question="What should I do when a check fails?">Understand a failed check ↗</button></div></div></div><p id="help-status" role="status">Checking your installed CLIs…</p><button id="retry-help" hidden>Retry connection</button><form id="help-form" hidden><label class="sr-only" for="question">Your question</label><textarea id="question" rows="3" maxlength="4000" placeholder="Ask a question…" required></textarea><div class="composer-controls"><label class="sr-only" for="help-agent">Use your CLI</label><select id="help-agent"></select><button type="button" id="stop-help" hidden>Stop</button><button class="primary" id="send-help" aria-label="Send message">Send ↗</button></div><small>Uses your CLI login and quota. Shift + Enter for a new line.</small></form><a id="help-guide" href="help.html">About your local companion →</a></aside></div>
|
|
147
|
+
<dialog id="search-dialog" aria-labelledby="search-title"><div class="dialog-title"><h2 id="search-title">Search documentation</h2><button data-close="search-dialog" aria-label="Close search">✕</button></div><label class="sr-only" for="search">Search all guides</label><input id="search" type="search" placeholder="Search workflows, settings, troubleshooting…" autocomplete="off"><div id="search-results" aria-live="polite"></div></dialog>
|
|
148
|
+
</body></html>
|