Flow Docs

High-signal docs for the Codex/Claude workflow:

• commands/ai.md: exact Claude/Codex session behavior (resume, TTY requirements, strict-ID semantics).
• commands/skills.md: f skills sync, f skills reload, and Codex skill metadata behavior.
• commands/commit.md: commit-time testing + skill-gate enforcement.
• commands/invariants.md: invariant policy checks (f invariants) and commit-time enforcement behavior.
• commands/fast.md: low-latency AI task dispatch (f fast) via fast daemon client path.
• commands/seq-rpc.md: native seqd RPC bridge (f seq-rpc) for OS-level agent actions.
• ci-cd-runbook.md: CI/CD architecture, runner-mode operations, and failure debug checklist for canary/release pipelines.
• install-script-latest-release-verification.md: exact runbook for proving curl -fsSL https://myflow.sh/install.sh | sh installs the current latest stable release.
• rise.md: full integration guide for installing and operating Rise via Flow (f install rise) across adopt/sync/dev/mobile/schema/sandbox workflows.
• commands/domains.md: shared local *.localhost proxy ownership via f domains (prevents per-repo port-80 collisions).
• commands/clone.md: git-like cloning (f clone) with GitHub URL/shorthand normalization to SSH, without forcing ~/repos.
• commands/up.md: one-command project startup (f up) with optional lifecycle domain setup.
• commands/down.md: one-command project shutdown (f down) with lifecycle teardown rules.
• commands/reviews-todo.md: fast-commit + deferred Codex deep-review backlog workflow.
• fast-commit-deep-review-loop.md: recommended speed-first workflow for ~/code/myflow (GLM/Cerebras fast lane + batched Codex deep reviews).
• how-to-use-flow-ai-to-manage-claude-code-sessions.md: practical session workflow for Claude + Codex in one repo loop.
• codex-first-control-plane-roadmap.md: concrete plan for making Flow the Codex-first control plane with warm app-server daemon, intent aliases, reference unrollers, and runtime skills.
• codex-openai-session-resolver.md: app-server-backed L <query> resolver for repo-scoped Codex session resume in ~/repos/openai/codex.
• codex-fork-tasks.md: personal Codex fork automation tasks for nikiv sync, scoped worktree/session start, last-session reattach, and review-branch promotion.
• session-history-mining.md: efficient cross-project session mining (f sessions) and prompt scaffolds for token-sensitive planning.
• session-semantic-recovery-with-seq.md: recover lost Claude/Codex work after resets using Seq's zvec-backed semantic session search plus f ai ... resume.
• env-security-roadmap.md: hardening plan for Flow env storage, local keychain-backed secrets, and future end-to-end encrypted sharing.
• how-to-make-a-project-flow-project.md: detailed onboarding and migration playbook for turning any repo into a Flow-native project.
• use-flow-to-write-software-better.md: full end-to-end operating model for building software with Flow + Claude/Codex.
• usage-analytics-rollout.md: exact patch order for opt-in anonymous usage tracking.
• flow-toml-spec.md: complete config schema including [skills.codex], [commit.testing], and [commit.skill_gate].
• local-domains-no-random-ports.md: stable *.localhost local domains via a lightweight proxy, plus flow.toml task wiring.
• local-domains-domainsd-cpp-spec.md: native C++ domainsd architecture, rollout, and reliability constraints for low-latency localhost routing.
• myflow-localhost-runbook.md: exact commands to run ~/code/myflow on myflow.localhost and use in-app /processes and /logs views.
• seq-agent-rpc-contract.md: hard interface contract for agent OS actions through seq_client -> seqd RPC v1.
• everruns-seq-bridge-integration.md: why/how f ai everruns now reuses Seq's shared Everruns bridge to avoid duplicate tool mapping logic.
• everruns-maple-runbook.md: exact commands to enable Everruns -> Maple dual-ingest and verify spans in local + hosted Maple.
• ascii-commit-visualization-pipeline.md: end-to-end pipeline for commit analysis -> Flow API -> box-of-rain ASCII/SVG diagrams in myflow.
• features.md: practical command flows and examples.
• moonbit-ai-tasks-implementation.md: complete inventory of the task-centric MoonBit AI task runtime and Flow-local .ai/tasks pack.
• ai-task-fast-path-guide.md: end-to-end setup and tuning guide for lowest-latency AI task execution (ai-taskd + fai).
• moonbit-rust-boundary-refactor-plan.md: deep scan findings, benchmark gates, and zero-cost MoonBit <> Rust boundary roadmap.
• bench/moonbit-rust-ffi-boundary.md: authoritative microbenchmark for MoonBit <-> Rust FFI overhead, plus tuning guidance.
• rl-for-myflow-harbor.md: practical RL roadmap for turning myflow -> Harbor exports into a gated training/improvement loop.
• rl-myflow-harbor-task-specs.md: executable task contracts for validate/reward/canary/hardcase stages.
• private-fork-flow.md: generic AI runbook for private-fork setup and safe push routing via Flow [git].remote.
• private-repo-fast.md: fastest way to create a private GitHub repo from the current folder, including non-~/repos paths like ~/code/flow-extension and separate private mirror remotes for existing public repos.
• commands/jj.md: Flow wrapper for jj workflows (sync, bookmarks, and workspace/lane management).
• jj-workspaces-for-parallel-work.md: practical parallel-branch workflow with isolated workspace lanes.
• jj-review-workspaces.md: stable JJ-native review workspaces for branch-specific inspection and edits without touching the current checkout.
• jj-home-branch-workflow.md: status-first workflow for a long-lived home branch with stacked review or codex branches in isolated JJ workspaces.
• moving-repos.md: how Flow manages repo locations, f migrate for moving projects with AI session continuity, and the ~/code / ~/repos / ~/run layout.
• run-repos.md: shortcuts and resolution rules for running tasks in ~/run and ~/run/i from anywhere.
• ai-run-task-fast-path.md: minimal prompt/response contract for AI to add public or internal run tasks quickly and return ready-to-run f ... commands.
• dependency-vendoring.md: inhouse dependency workflow, offender ranking, and fast upstream sync loop for vendored crates.
• vendor-code-intelligence.md: opensrc-style local code indexing/search for vendored crates + first-party code via Typesense.
• vendor-nix-inspiration.md: how Flow vendoring borrows Nix ideas (pinning, reproducibility, provenance, rollback) while staying Cargo-first.
• vendor-optimization-loop.md: rough-edge audit + offender ranking + iteration benchmarks for dependency optimization.