{"id":45406079,"url":"https://github.com/dotcommander/vybe","last_synced_at":"2026-02-28T07:02:36.128Z","repository":{"id":338303659,"uuid":"1157408729","full_name":"dotcommander/vybe","owner":"dotcommander","description":"CLI for AI coding agents: persistent tasks, memory, events, and deterministic resume across crashes and session resets.","archived":false,"fork":false,"pushed_at":"2026-02-22T00:26:24.000Z","size":1350,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-22T00:50:19.148Z","etag":null,"topics":["agent-framework","ai-agents","claude","cli","developer-tools","golang","sqlite","task-management"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dotcommander.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-13T19:33:52.000Z","updated_at":"2026-02-22T00:34:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dotcommander/vybe","commit_stats":null,"previous_names":["dotcommander/vybe"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/dotcommander/vybe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotcommander%2Fvybe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotcommander%2Fvybe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotcommander%2Fvybe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotcommander%2Fvybe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dotcommander","download_url":"https://codeload.github.com/dotcommander/vybe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dotcommander%2Fvybe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29927187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"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":["agent-framework","ai-agents","claude","cli","developer-tools","golang","sqlite","task-management"],"created_at":"2026-02-21T21:21:47.834Z","updated_at":"2026-02-28T07:02:36.123Z","avatar_url":"https://github.com/dotcommander.png","language":"Go","readme":"# vybe\n\nDurable continuity for AI coding agents.\n\n`vybe` gives autonomous agents crash-safe task tracking, append-only event logs, scoped memory, deterministic resume, and artifact linking — all backed by a single SQLite file. Agents pick up exactly where they left off across sessions without human intervention.\n\n## The Problem\n\nAI coding agents lose context when sessions end. Crashes, context resets, and handoffs between agents mean work gets repeated, forgotten, or abandoned. There is no standard place to store what an agent was doing, what it learned, or what it produced.\n\n`vybe` is that place.\n\n![vybe demo](demo.gif)\n\n## Features\n\n**Task lifecycle**\n- Create, begin, complete, and block tasks with priority and dependencies\n- Dependency-aware progression via deterministic resume focus selection\n- Valid statuses: `pending`, `in_progress`, `completed`, `blocked`\n\n**Event log**\n- Append-only structured log of all agent activity\n- Query via `events list`, summarize, and ingest from external sources\n\n**Scoped memory**\n- Key-value store scoped to global / project / task / agent\n- TTL and GC support\n- PreCompact runs checkpoint maintenance (event + memory hygiene)\n\n**Deterministic resume**\n- 5-rule focus selection algorithm — no ambiguity on restart\n- Brief packets deliver task + memory + events + artifacts in one JSON call\n- Cursor-based delta tracking per agent\n\n**Idempotent mutations**\n- Every mutating command accepts `--request-id`\n- Duplicate requests replay the original result safely\n- Safe for retries and at-least-once agent execution\n\n**Multi-agent coordination**\n- Per-agent state, focus tracking, and heartbeats\n- Optimistic concurrency on task and agent state rows\n- Retry-safe idempotent mutations for concurrent workers\n\n**Hook integration**\n- One-command install for Claude Code and OpenCode\n- Hooks cover: SessionStart, UserPromptSubmit, PostToolUseFailure, TaskCompleted, PreCompact, SessionEnd\n- Bidirectional context injection — resume data flows into each new session\n\n**Internal maintenance**\n- Checkpoint/session-end run event summarization and archived-event pruning automatically\n- Maintenance policy is configurable in `config.yaml` (`events_retention_days`, `events_prune_batch`, `events_summarize_threshold`, `events_summarize_keep_recent`)\n- `vybe status --check` verifies DB connectivity\n\n**SQLite-backed**\n- WAL mode, single file, no server required\n- Busy-timeout and retry logic built in\n- Schema introspection via `vybe schema commands`\n\n**Project scoping**\n- Group tasks and memory under named projects\n- Focus project filters memory and task selection\n\n## Quick Start\n\n```bash\n# 1) install\ngo install github.com/dotcommander/vybe/cmd/vybe@latest\n\n# 2) connect your assistant\nvybe hook install            # Claude Code\n# OR\nvybe hook install --opencode # OpenCode\n\n# 3) set agent name\nexport VYBE_AGENT=worker1\n\n# 4) verify\nvybe status --check\n```\n\nIf `vybe status --check` returns `query_ok=true`, setup is done.\n\n## First Task\n\n```bash\n# create work\nvybe task create --request-id task_1 --title \"Ship feature\" --desc \"Implement X\"\n\n# get current focus + context\nvybe resume --request-id resume_1\n\n# close when done (canonical agent path)\nvybe task set-status --request-id done_1 --id \u003cTASK_ID\u003e --status completed\n```\n\nIf a session crashes, run `vybe resume` and keep going.\n\n## Architecture\n\n```\ncmd/vybe/main.go\n  ↓\ninternal/commands/     # CLI layer — parse flags, call actions\n  ↓\ninternal/actions/      # Business logic — orchestrate store calls\n  ↓\ninternal/store/        # SQLite persistence — transactions, retry, CAS\n```\n\n**Commands:** `artifacts`, `events`, `hook`, `loop`, `memory`, `push`, `resume`, `schema`, `status`, `task`, `upgrade`\n\nSee [`docs/`](docs/) for full documentation.\n\n## Documentation\n\n| Doc | Contents |\n|-----|----------|\n| [`docs/operator-guide.md`](docs/operator-guide.md) | Install/bootstrap plus operational loop recipes |\n| [`docs/agent-contract.md`](docs/agent-contract.md) | Canonical machine I/O and integration contract |\n| [`docs/contributor-guide.md`](docs/contributor-guide.md) | Contributor workflow for safe code changes |\n| [`docs/decisions.md`](docs/decisions.md) | Why command-surface choices exist and what must not regress |\n\n## Uninstall\n\n```bash\nvybe hook uninstall            # Claude Code\nvybe hook uninstall --opencode # OpenCode\n```\n\nState is stored in `~/.config/vybe/`. Remove that directory to wipe all data.\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotcommander%2Fvybe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdotcommander%2Fvybe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotcommander%2Fvybe/lists"}