{"id":46152490,"url":"https://github.com/valksor/kvelmo","last_synced_at":"2026-04-01T17:10:07.781Z","repository":{"id":331550887,"uuid":"1123431973","full_name":"valksor/kvelmo","owner":"valksor","description":"Whether you're a product manager describing a feature, an ops person fixing a process, or a developer automating routine work — kvelmo provides the guardrails to ship changes safely. It coordinates your local AI agent to handle the mechanics while you stay in control of review and approval.","archived":false,"fork":false,"pushed_at":"2026-03-30T06:31:31.000Z","size":12664,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-30T08:34:42.298Z","etag":null,"topics":["ai","automation","claude","orchestration","planning","review","valksor","wrapper"],"latest_commit_sha":null,"homepage":"https://valksor.com/docs/kvelmo/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valksor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"ko_fi":"valksor","thanks_dev":"u/gh/valksor","issuehunt":"valksor/kvelmo","buy_me_a_coffee":"valksor"}},"created_at":"2025-12-26T21:29:09.000Z","updated_at":"2026-03-30T06:31:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/valksor/kvelmo","commit_stats":null,"previous_names":["valksor/go-mehrhof","valksor/kvelmo"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/valksor/kvelmo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valksor%2Fkvelmo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valksor%2Fkvelmo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valksor%2Fkvelmo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valksor%2Fkvelmo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valksor","download_url":"https://codeload.github.com/valksor/kvelmo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valksor%2Fkvelmo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","automation","claude","orchestration","planning","review","valksor","wrapper"],"created_at":"2026-03-02T09:04:08.807Z","updated_at":"2026-04-01T17:10:07.773Z","avatar_url":"https://github.com/valksor.png","language":"Go","funding_links":["https://ko-fi.com/valksor","https://thanks.dev/u/gh/valksor","https://issuehunt.io/r/valksor/kvelmo","https://buymeacoffee.com/valksor"],"categories":[],"sub_categories":[],"readme":"# kvelmo\n\n[![valksor](https://badgen.net/static/org/valksor/green)](https://github.com/valksor)\n[![BSD-3-Clause](https://img.shields.io/badge/BSD--3--Clause-green?style=flat)](https://github.com/valksor/kvelmo/blob/master/LICENSE)\n[![GitHub Release](https://img.shields.io/github/release/valksor/kvelmo.svg?style=flat)](https://github.com/valksor/kvelmo/releases/latest)\n[![GitHub last commit](https://img.shields.io/github/last-commit/valksor/kvelmo.svg?style=flat)](https://github.com/valksor/kvelmo/commits/master)\n[![Coverage Status](https://coveralls.io/repos/github/valksor/kvelmo/badge.svg?branch=master)](https://coveralls.io/github/valksor/kvelmo?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/valksor/kvelmo)](https://goreportcard.com/report/github.com/valksor/kvelmo)\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/valksor/kvelmo)\n\nkvelmo is a local orchestration system for AI-assisted development.\n\nIt manages the full lifecycle of development tasks — from loading requirements through planning, implementation, review, and pull request submission. The Web UI and desktop app are the main experience, with CLI and TUI available for those who prefer them.\n\nkvelmo is not the agent. It is the system around the agent: workspace setup, checkpoints, approvals, governance, observability, and recovery.\n\n\u003e **Note:** kvelmo is currently only available through [nightly builds](https://valksor.com/docs/kvelmo/nightly/) or by building from source. There is no stable release yet.\n\n## Why Use It\n\n- **Web-first workflow** for creating tasks, watching progress, reviewing changes, and managing project state visually\n- **Human oversight at every step** so planning, implementation, review, and submission stay explicit and inspectable\n- **Runs locally** with no hosted service required for the core workflow\n- **Works across interfaces** so you can start in the browser and continue in CLI or TUI without losing context\n- **Recovery built in** through checkpoints, undo/redo, reset paths, and resumable task state\n- **Operational depth** beyond the happy path: policy, CI, security, activity logs, exports, recordings, notifications, and task grouping\n\n## How It Works\n\n```text\nstart -\u003e plan -\u003e implement -\u003e simplify? -\u003e optimize? -\u003e review -\u003e submit -\u003e finish\n```\n\nEach phase updates task state, records checkpoints, and exposes progress to every interface.\n\nAt a high level:\n\n1. **Start** loads work from a file or provider and prepares the workspace\n2. **Plan** produces a reviewable specification before code changes begin\n3. **Implement** executes the approved direction in the project workspace\n4. **Simplify** and **Optimize** are optional refinement passes\n5. **Review** adds the human checkpoint before code leaves the machine\n6. **Submit** creates the PR and updates provider-facing state\n7. **Finish** cleans up after merge\n\n## Choose Your Interface\n\n### Desktop App\n\nThe desktop app is a native application for managing your workflow visually — no terminal required.\n\n**[Desktop App Guide](https://valksor.com/docs/kvelmo/nightly/#/desktop/index)**\n\n### Web UI\n\nThe browser UI gives you the same visual experience, started from one command:\n\n```bash\nkvelmo serve --open\n```\n\nThen open `http://localhost:6337` if it did not open automatically.\n\nUse the Web UI when you want:\n\n- project and task dashboards\n- visual workflow controls\n- live output, chat, logs, and review context\n- access to panels for memory, screenshots, browser automation, jobs, code graph, recordings, policy, CI, and more\n\n**[Web UI Guide](https://valksor.com/docs/kvelmo/nightly/#/web-ui/getting-started)**\n\n### CLI\n\nThe CLI is available for scripting, shell-native workflows, automation, and provider operations.\n\n```bash\nkvelmo start --from file:task.md\nkvelmo plan\nkvelmo implement\nkvelmo review\nkvelmo submit\n```\n\n**[CLI Reference](https://valksor.com/docs/kvelmo/nightly/#/cli/index)**\n\n### TUI\n\nThe TUI gives you a full-screen terminal dashboard with workflow control and live output, without switching to a browser.\n\n```bash\nkvelmo tui\n```\n\n## What kvelmo Is\n\n- **An orchestrator for development work** — it coordinates AI agents, it is not one itself\n- **A local product** that runs on your machine with no hosted service required\n- **A workflow system** with clear steps, approvals, and recovery at every stage\n- **Available everywhere** — desktop app, Web UI, CLI, TUI, and RPC\n- **A governance layer** for policy checks, approvals, auditability, and submission discipline\n\n## What kvelmo Is Not\n\n- **Not a one-click autonomous coder** that silently edits and ships code\n- **Not a hosted service** — the core workflow runs entirely on your machine\n- **Not only a shortcut to PRs**; it also handles the operational edges around agent work\n- **Not limited to a single agent**; Claude, Codex, and custom agents can all participate\n\n## Key Capabilities\n\n| Capability | What It Covers |\n|------------|----------------|\n| **Task intake** | Files plus providers such as GitHub, GitLab, Linear, Wrike, Jira, and Azure DevOps |\n| **Workflow orchestration** | Start, plan, implement, simplify, optimize, review, submit, finish |\n| **Checkpointing** | Undo, redo, reset, abandon, and resumable task history |\n| **Observability** | Status, watch, logs, activity, jobs, stats, recordings, event log |\n| **Governance** | Approvals, checklisting, policy, CI checks, security scanning, audit trail |\n| **Project intelligence** | Memory, screenshots, browser automation, code graph, discovery, recap, explain |\n| **Operations** | Backups, exports, notifications, access tokens, hooks, worker pools, task groups |\n\n## Installation\n\nkvelmo is currently available through nightly builds or by building from source.\n\n**Nightly build:**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/valksor/kvelmo/master/install.sh | bash\n```\n\n**Build from source:**\n\n```bash\ngit clone https://github.com/valksor/kvelmo.git\ncd kvelmo\nmake build\nmake install\n```\n\nAfter installation:\n\n```bash\nkvelmo version\nkvelmo diagnose\n```\n\nIf your preferred agent CLI is available locally, kvelmo can orchestrate it. Claude CLI is the default path, and Codex plus custom/API-backed agents are also supported.\n\n## Getting Started\n\nThe fastest way to start is the desktop app or Web UI. For the Web UI:\n\n```bash\nkvelmo serve --open\n```\n\nFor CLI users, the core workflow commands are:\n\n```bash\nkvelmo start \"Refactor the settings panel\"\nkvelmo plan\nkvelmo implement\nkvelmo review\nkvelmo submit\n```\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Quickstart](https://valksor.com/docs/kvelmo/nightly/#/quickstart) | Get started and learn the workflow |\n| [Desktop App](https://valksor.com/docs/kvelmo/nightly/#/desktop/index) | Native application guide |\n| [Web UI Guide](https://valksor.com/docs/kvelmo/nightly/#/web-ui/getting-started) | Browser experience |\n| [CLI Reference](https://valksor.com/docs/kvelmo/nightly/#/cli/index) | Command reference |\n| [Workflow Concepts](https://valksor.com/docs/kvelmo/nightly/#/concepts/workflow) | Steps, approvals, and recovery |\n| [Providers](https://valksor.com/docs/kvelmo/nightly/#/providers/index) | External task sources |\n| [Configuration](https://valksor.com/docs/kvelmo/nightly/#/configuration/index) | Settings, tokens, and behavior |\n\n## Development\n\n```bash\nmake build\nmake quality\nmake test\n```\n\nSee `CONTRIBUTING.md` for the full contributor workflow.\n\n## Prototype\n\n`prototype/` contains the historical reference implementation that informed the current architecture. It is preserved as read-only reference material and is not the active development target.\n\n## License\n\n[BSD 3-Clause License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalksor%2Fkvelmo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalksor%2Fkvelmo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalksor%2Fkvelmo/lists"}