{"id":51468522,"url":"https://github.com/panarch/caffold","last_synced_at":"2026-07-06T14:01:33.600Z","repository":{"id":369113764,"uuid":"1288057420","full_name":"panarch/caffold","owner":"panarch","description":"Scaffolding for agent-assisted development","archived":false,"fork":false,"pushed_at":"2026-07-03T16:04:26.000Z","size":457,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-03T18:09:57.732Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/panarch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-03T08:32:23.000Z","updated_at":"2026-07-03T16:04:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/panarch/caffold","commit_stats":null,"previous_names":["panarch/caffold"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/panarch/caffold","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panarch%2Fcaffold","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panarch%2Fcaffold/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panarch%2Fcaffold/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panarch%2Fcaffold/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/panarch","download_url":"https://codeload.github.com/panarch/caffold/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panarch%2Fcaffold/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35193679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-06T14:01:30.515Z","updated_at":"2026-07-06T14:01:33.191Z","avatar_url":"https://github.com/panarch.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Caffold\n\nCaffold is scaffolding for agent-assisted development: a browser-based review and control surface that helps developers inspect, guide, and validate Codex-backed code work across git worktrees.\n\nIt runs Codex-powered development tasks on a trusted host and gives the developer a browser-based surface for reviewing task state, diffs, files, test results, approvals, and follow-up prompts.\n\nCaffold is not an autonomous coding product, an IDE, or a replacement for the Codex GUI.\n\nIts narrower goal is to make agent-generated code review practical away from the desktop app, including on mobile and foldable devices.\n\n## Why\n\nFoldable phones and wider mobile displays make it increasingly plausible to review real code changes away from a desk.\n\nAgent-assisted development makes that more useful. The developer still makes the judgment calls, but more of the day-to-day work becomes reading diffs, checking tests, inspecting files, approving commands, and sending follow-up prompts instead of typing every edit by hand.\n\nThat shift makes a browser-based review console practical. The important surface is not a full editor. It is a fast, reliable way to inspect agent output and decide what should happen next.\n\nFor long-running code work, the hard part is often not the agent itself. It is the surface around the agent: finding the right session again, understanding which worktree changed, reading the diff without opening a full editor, approving commands remotely, and continuing the review loop from another device.\n\nCodex remains the work execution engine. The git worktree remains the construction site. Caffold is the structure a developer uses to get close to the work, inspect it, guide it, and decide what is safe to keep.\n\n## Shape\n\nThe intended shape is:\n\n- a Rust backend running on each trusted host\n- a browser/PWA frontend served by that backend\n- Codex app-server managed as a child process\n- JSON-RPC integration between the backend and Codex app-server\n- GlueSQL with redb for Caffold-owned metadata and event history\n- git worktrees as the source of truth for code changes\n- Tailscale or another trusted private network for remote access\n\n## Core Principle\n\nCaffold should make agent output easier to inspect, question, accept, reject, and continue.\n\nIt should not try to become VS Code, a full git GUI, or a native mobile app.\n\n## Run\n\nStart the first read-only file browser slice:\n\n```sh\ncargo run -- serve\n```\n\nThen open the printed local URL. By default Caffold opens at `$HOME`, displays it as `~`, and allows read-only parent navigation up to the filesystem root.\n\nFor deterministic local testing, a bounded root can be supplied:\n\n```sh\ncargo run -- serve --root tests/fixtures/home\n```\n\n## Test\n\nRun Rust checks:\n\n```sh\ncargo test\ncargo fmt --check\ncargo clippy --all-targets -- -D warnings\n```\n\nRun browser tests:\n\n```sh\nnpm run test:e2e\n```\n\nPlaywright tests verify behavior and write review screenshots under the ignored `test-results` directory. Caffold does not commit Playwright snapshot baselines; future CI visual checks should compare screenshots generated from `main` and the pull request head in the same runner.\n\n## Documentation\n\nPublic-facing docs:\n\n- [Vision](docs/public/vision.md)\n- [Architecture](docs/public/architecture.md)\n\nInternal planning notes:\n\n- [MVP](docs/internal/mvp.md)\n- [Roadmap](docs/internal/roadmap.md)\n- [Workflows](docs/internal/workflows.md)\n- [Codex App Server](docs/internal/codex-app-server.md)\n- [Worktree Lifecycle](docs/internal/worktree-lifecycle.md)\n- [Operation Ledger](docs/internal/operation-ledger.md)\n- [UI Surfaces](docs/internal/ui-surfaces.md)\n- [Frontend Structure](docs/internal/frontend-structure.md)\n- [Security and Approvals](docs/internal/security-approvals.md)\n\n## Status\n\nThis repository has an initial read-only web file browser slice. The broader Codex-connected review and control surface remains under active design and implementation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanarch%2Fcaffold","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpanarch%2Fcaffold","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanarch%2Fcaffold/lists"}