qorvyn
v1.29.0
Published
One engineering brain for all your AI coding agents: cited project context (CLI, MCP, SDK), approved multi-agent workflows with guardrails, safe delivery, and team sharing. Local-first.
Maintainers
Readme
Qorvyn 1.29.0
One engineering brain for all your AI coding agents. Qorvyn gives Claude Code, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode and your own scripts the same cited understanding of your project, runs them as specialists in workflows you approve, and keeps them inside guardrails Qorvyn enforces itself. Your code stays on your machine.
- Cited project context. An incremental index of your repository. Every answer comes with
path:lines@commit, through the CLI, an MCP server, a local HTTP API and SDKs. - Describe a goal, approve the plan. A planner turns a goal into a workflow of agent steps (architect, developer, reviewer, tester) and shows it before anything runs.
- Safe by design. Agents that change files work in their own git worktrees and commit to their own branches, never to your checkout. Protected paths, denied capabilities, allowed providers and time limits are enforced outside the model. Privileged actions need your approval for each run.
- Safe delivery. Merge locally, or push and open pull requests on GitHub, GitLab, Azure DevOps and Bitbucket.
- Any agent, any model. Claude Code, Codex and GitHub Copilot built in; any CLI agent or chat API (Anthropic, OpenAI-compatible, local models) can be added. API keys are write-only.
- Teams. Share agents, workflows and knowledge through a server you host, and run work on other computers with runners.
- Adds no files to your repository. Everything lives in
~/.qorvyn.
Install
Needs Node.js 22.13 or newer and Git. macOS, Linux and Windows (Intel/AMD and ARM).
npm install -g qorvyn # once per computer; works with any repository, in any languageInstalling, activating and qorvyn init change nothing in your repository: no file, nothing inside .git, nothing in git status or its history. (npm install -D qorvyn also works in a JavaScript/TypeScript project, run with npx qorvyn, but it adds Qorvyn to that project's package.json and package-lock.json.)
Quick start
qorvyn activate # once: sign in for your free account (Microsoft, or an email code)
cd your-repo
qorvyn init # index the repo, set up agents and workflows for you to review
qorvyn context search "authentication middleware"
qorvyn do "rate limit the login endpoint, with tests"
qorvyn dashboard # the local dashboard (127.0.0.1)
qorvyn --helpUse it from your agent
qorvyn init --setup-mcp claude (or codex, copilot, or all) registers Qorvyn's MCP server with your agent, in your user settings, never in the repository. It offers read-only tools to search code, read files, look up symbols and keep private notes. Anything else that speaks MCP can start it with qorvyn mcp.
Plans
- Free: for individuals. A free account with up to three personal projects (a project is one product, not a folder or a clone). It does not expire. Organizations you belong to have their own allowance; they never use your personal projects.
- Teams and Enterprise: the team server, runners and, for Enterprise, policies, SSO and SCIM, governance of runners and spending, and signed audit evidence. Per seat: contact FACTn Software.
Teams: server and runners
qorvyn server start # a self-hosted team server (one small Go binary, PostgreSQL)
qorvyn login --server https://team.example.com
qorvyn team link # link this repository to the team's workspace
qorvyn runner enroll <server> <token> # let this computer run approved tasks for the teamThe server binary for your platform is installed automatically as @factn-software/qorvyn-server-<os>-<cpu>.
SDKs
Official clients for the local runtime API in Dart, .NET, Go, Java, Kotlin, Python, Rust, Swift and TypeScript (import { connect } from "qorvyn"). The contract is contracts/qorvyn-runtime.openapi.yaml in this package.
Privacy and security
- Your code, prompts, index and notes stay on your computer. Agents you run talk to their own providers under those providers' terms.
- What Qorvyn contacts: the FACTn account service for a short signed authorization check before protected commands (your device, project slot and the command name, never code or file names); the Git hosts and providers you choose; and, unless you turn it off with
qorvyn telemetry offorDO_NOT_TRACK=1, one anonymous usage report a week. There is no offline grace period: Qorvyn needs an internet connection for protected commands. - Supply chain: three exact-pinned runtime dependencies (
@modelcontextprotocol/sdk,yaml,zod) and no install scripts. Releases are built and signed by FACTn Software. - Details: privacy and data governance.
Links
Website · Documentation · Release notes · Contact
License
Qorvyn is proprietary software of FACTn Software (Pvt) Ltd, free to use under the Qorvyn Free Use License 1.0 (LicenseRef-FACTn-Qorvyn-Free-Use-1.0): LICENSE. You keep ownership of everything you create with it; you may not modify, reverse engineer or redistribute Qorvyn, or offer it as a service. Qorvyn Team, Enterprise and other paid plans have their own agreements. Third-party components keep their own licenses: THIRD_PARTY_NOTICES.txt, NOTICE.
