We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
There was an error while loading. Please reload this page.
docs: document agent CLI and MCP integration
docs: multi-forge support (GitHub / GitHub Enterprise / GitLab) for 0.70 New Multi-Forge-Support page + updates to Command-Reference, Config-Overview (forgeHosts), Issue-PR-Triage, Home, and Troubleshooting (glab).
docs: document 0.66-0.68 features - Command-Reference: add `coco amend` and `coco pr create`; document the global --json/--quiet flags, `review --severity`/`--staged`, and `doctor --cost`. - Config-Overview: extend service.provider to all seven providers (gemini, mistral, azure, bedrock) with config examples + env vars, the new structural fast-path languages (Java/C/C++/C#/Ruby/PHP), and the commitSplit routing task. - Coco-UI + TUI-Navigation: document the actionable reflog keys (c checkout, Z reset, B branch). - Home + Getting-Started: add the new commands and the seven-provider list.
docs(themes): update theme counts to 108 (color theme release) Reflects the expanded catalog (108 color themes / 109 presets, 29 light) in the config, log-TUI, navigation, and home pages. Pairs with the coco color theme release.
docs: update for 0.57.0 bare-`coco` smart routing Bare `coco` (no subcommand) now routes to init / ui / workspace instead of defaulting to commit, so every doc that used bare `coco` to mean 'generate a commit' was wrong. Across all pages: - Rewrite bare-`coco` commit examples to explicit `coco commit …` (incl. $(coco) subshells and `coco | git commit` pipes). - Add a 'Smart default routing' section to Command-Reference and Getting-Started documenting the init/ui/workspace table + the --commit / COCO_DEFAULT=commit escape hatch. - Heads-up callouts in the onboarding flow.
docs: refresh theme counts, preset lists, and view counts for 0.57.0 - Theme/preset references updated from the old 4-preset lists to the current 49 color themes / 50 presets (17 light), linking the gallery. - coco ui view count corrected to 16 (Command-Reference, Home). - Note that the active/selected row is now readable on every theme. - Clarify logTui.theme.preset is shared by coco log -i and coco ui.
feat: add Workspace page covering `coco workspace` / `coco ws` Full user-facing reference for the multi-repo overview TUI: - Start commands + flags (`--root`, `--max-depth`, `--theme`) - Layout sketch with chip header, rail-collapsible sidebar, table body with responsive column drop priority - Focus model (sidebar / list with tab cycling; modal focuses for filter / add-repo / confirm-delete) - Full keymap grouped into Navigate / Filter & sort / Repos / General - Drill-in loop semantics (chdir, mount ui, restore on exit) - Sort modes + filter behavior - Add / remove repo flow including the per-user known-repos store - Configuration reference (`workspace.roots`, `knownRepos`, `maxDepth`) - Performance + resilience notes - Troubleshooting (no repos discovered, PR counts missing, dev watcher capturing keys, slow network FS) Linked from Home.md under the TUI section.
docs(scenarios): refresh Testing-Scenarios for git-scenarios 0.5.0 The page was written when the package was at v0.3.0/0.3.1 with 19 scenarios; the registry has grown to 27 across the v0.3.2 → v0.5.0 releases and the package now exposes a Jest framework adapter plus programmatic registration. Brought the page back in sync. Changes: - Total bumped 19 → 27 across the kind tables. - Added missing scenarios that landed since the original draft: empty-repo (0.3.2), branch-sync-showcase (0.3.3), mid-rebase-conflict + mid-cherry-pick-conflict (0.4.0), multiple-worktrees + shallow-clone + large-repo + mid-revert-conflict (0.5.0). - Rewrote the in-progress operations section to surface the complete conflict matrix (merge / rebase / cherry-pick / revert) with each state's .git/ marker file. - New "I'm working on the conflicts view" workflow block calls out the four-scenario cycle as the right way to audit any conflict-view changes. - New "stress-test history" + "worktrees view" workflow blocks for large-repo and multiple-worktrees. - New "Path A — the Jest framework adapter" section describing describeWithScenario / describeEachScenario / describeWithScenarioExtended as the preferred surface for new tests. The raw spinUpScenario API becomes Path B for cases that need finer lifecycle control. - New "Path B — fromScenario" + "Path C — register a coco-specific scenario at runtime" sections in the "compose your own" guide. - "Where things live" mentions the Jest adapter subpath export and the bin/scenarioRunner.ts wrapper that makes --run-ui work. Home.md tile copy refreshed to match: 19 → 27, conflict matrix language ("merge / rebase / cherry-pick / revert"), describeWithScenario swapped in for the older spinUpScenario one-liner.
docs: add Testing-Scenarios page Comprehensive guide to coco's scenario library: - The 19 named scenarios available, grouped by kind - The npm run scenario CLI (list, describe, create + flags) - Common dev workflows for each TUI surface (chip-rendering-showcase, mid-merge-conflict, branch-diverged, etc) - How to compose scenarios inline in tests via the atom layer - How to use spinUpScenario in jest integration tests - Pointers to the @gfargo/git-scenarios package for contributing new scenarios back Also surfaces the page on Home.md so it's discoverable from the landing index.
Document issue / PR triage workflow (#882)
Refresh Coco-UI / TUI-Navigation / Commit-Split / Command-Reference / Home Catches up the canonical user docs to the 0.49.x workstation: - Adds C / L / E / S keystrokes under History view + Compose - Documents the just-landed commit marker (▎ accent bar for ~5s after apply) - Documents the directive next-step hint surfaced post-commit / post-split - "Nine" → "Thirteen" views (changelog joined the list) - New chord entries: g x (conflicts) / g r (reflog) / g B (bisect) - New "One-keystroke workflows" table for C / L / S / E / I / B / + - Adds the workstation-first quick start (S keystroke in compose) - New "Commit Message Style" section documenting: - Conventional Commits format honored when configured - Commitlint integration auto-detected - Branch name passed as prompt context - Same LLM service config as `coco commit` (incl. dynamic model routing) - New "Resilient Plan Validation" section explaining the 4-pass rescue chain - Adds the per-commit HEAD-verification safety rule - Adds the empty-groups filter safety rule - New Global Options section calls out `--repo <dir>` (alias `--cwd`) explicitly - Worked examples for each subcommand (commit/ui/log/doctor/init) with --repo - Coco UI feature bullets list now mentions 13 views + the one-keystroke workflows + the just-landed marker - Commit Split bullets mention conventional-commits / commitlint inheritance + workstation S workflow + rescue chain
docs: remove internal specs and roadmap pages from wiki Moved to specs/ in the main repo (gitignored): - Command-Reliability-Audit.md (internal v1 audit) - AI-Call-Audit.md (internal LLM call inventory) - AI-Assisted-Merge-Conflict-Resolution.md (future feature design) - AI-Commit-Range-Recomposition.md (future feature design) - Worktree-And-Parallel-Agent-Workspaces.md (future feature design) Updated Home.md to remove roadmap section and add Reference section with Command Reference and OpenRouter links.
docs: add TUI-Navigation as the canonical shell reference Tier 3 follow-up to the Tier 1+2 keymap fixes. Consolidates the navigation, palette, search, help, breadcrumb, theming, and accessibility documentation into a single page so future polish (new chords, palette features, themes) only has to update one place. New --- - TUI-Navigation.md Mental model + views/chords table + going back + contextual transitions + palette + search + help + footer + breadcrumb + themes/a11y + v0.34.0 migration note + a quick-reference card. ~190 lines. Slimmed (linked to the new page) -------------------------------- - Coco-UI.md Navigation section trimmed to a quick chord block + link. Keybindings split into "Within a view" / Compose / Workflow actions (the surface-specific bits); the Global and Navigation chords subsections moved to TUI-Navigation.md. - Interactive-Log-TUI.md Navigation section trimmed similarly. Keybindings table now covers only the history surface; navigation/palette/help rows removed in favor of a link to TUI-Navigation.md. - Home.md New entry for TUI Navigation alongside Coco UI in the Advanced Features section. Coco UI bullets refreshed to call out the seven-view + chord nav model. Net effect: ~190 lines added, ~36 lines duplicated content removed. The two surface pages stay focused on what's specific to them. Tracks 0.34.0.
docs: add coco ui guide
docs: document interactive log TUI
docs: add git workflow roadmap designs
docs: migrate coco docs to wiki
Updated Home (markdown)
Initial Home page