Define the change once. Ship it everywhere.
ShiftOps plans, coordinates, and verifies code migrations across every repository from one place.
Built for Devin Hacks Kochi 2026
Repository: https://github.com/ABDULMUNAFZ/ShiftOps
- Product walkthrough: Watch the ShiftOps demo on YouTube
- Companion website: onlyhacks.tech
ShiftOps is an independent project built for Devin Hacks Kochi 2026. It is not an official Cognition product.
Engineering teams repeat the same change across many repositories: runtime upgrades, dependency replacements, vulnerability remediation and platform standardisation. Each repository is handled separately. Ordering mistakes break consumers, progress is tracked in spreadsheets, and "done" often means an agent or engineer said so.
ShiftOps treats all repositories as one connected engineering system. It discovers affected projects, analyses their relationships, plans the correct change order, prepares repository-specific work for Devin and independently verifies every result.
ShiftOps
- Discovers affected repositories
- Understands dependencies and risk
- Plans migration waves
- Prepares repository-specific Devin tasks
- Independently verifies results
- Tracks the complete transformation
Devin
- Understands an individual repository
- Implements the requested code changes
- Repairs build and test failures
- Produces a branch or pull request
ShiftOps is built in six tasks. This table records what exists today.
| Task | State |
|---|---|
| 1. Desktop foundation, environment checks, website | Complete |
| 2. SQLite persistence, OS keychain, safe process runner, activity | Complete |
| 3. Product profile, local repository intelligence, GitHub | Complete |
| 4. Campaign planning, dependency intelligence, Devin integration | Complete (local Devin CLI; see below) |
| 5. Migration execution, independent verification, Devin repair loop | Complete (live Devin dispatch not exercised; see below) |
| 6. End-to-end workflow, packaging, security audit, submission | In progress: repository-management hardening done; packaging, audit and submission not started |
Details, decisions and test results: PROJECT_STATE.md. Change history: CHANGELOG.md.
- Repository intake: five import actions (Open Local Repository, Discover Folder, GitHub Metadata Only, Clone into Managed Workspace, Link Existing Clone), read-only Git inspection, and explicit trust levels.
- Repository intelligence: a read-only scanner for runtimes, package managers, frameworks, scripts, Docker and CI. Every fact carries its file and line or JSON pointer.
- GitHub: OAuth device flow or a fine-grained token kept in the OS keychain; browse and search; pull requests with check summaries.
- Campaigns: one objective across many repositories. A deterministic planner classifies members, scores risk with cited evidence and builds dependency-first waves.
- Devin delegation: a generated task per repository. You approve its exact text (SHA-256 pinned). Dispatch runs the local Devin CLI in its sandbox, only for trusted, clean checkouts.
- Independent verification and repair: ShiftOps runs each repository's own checks and records real exit codes. Repairable failures become bounded repair tasks, at most 2 per repository.
- Audit trail: an Activity Centre for every import, trust change, approval, dispatch, verification and cleanup.
- Submission Readiness: an evidence checklist for this repository (documents, push state, validation of HEAD, a bounded secret scan).
git clone https://github.com/ABDULMUNAFZ/ShiftOps.git && cd ShiftOps
pnpm install
pnpm dev:desktop # desktop app with hot reload
pnpm dev:website # marketing site at http://localhost:3000
pnpm check # format, types, lint, JS + Rust tests, ClippyThere are no signed installers yet. To build a local, unsigned installer, run pnpm --filter @shiftops/desktop tauri build. The user manual walks through a full campaign.
React UI (web view, no shell/fs/http/sql permissions)
│ typed IPC: Zod-validated results, structured errors
▼
Rust core (Tauri 2)
├─ SQLite (rusqlite, versioned migrations, backups before upgrades)
├─ OS keychain (tokens never leave Rust)
├─ ProcessRunner: argument vectors only, per-purpose policies
│ environment checks · read-only Git · one managed clone ·
│ Devin status/dispatch · approved verification plans
├─ Scanner, planner evidence, GitHub client, verification engine
└─ Activity log (redacted)
Details are in ARCHITECTURE.md and the threat model is in SECURITY.md.
pnpm check runs Prettier, TypeScript, ESLint, Vitest (110 tests across the workspace), rustfmt, cargo test (208 tests; 3 manual rehearsals ignored) and Clippy with -D warnings. CI runs the same checks on Linux, macOS and Windows. Rust tests use temporary databases and a test keychain service, and real Git runs only against temporary repositories.
apps/
desktop/ Tauri 2 + React desktop app (Rust backend in src-tauri/)
website/ Next.js static site: landing, docs, security, privacy, download
packages/
core/ Domain and error contracts (Zod), settings model, migration wave planner
ui/ Shared design tokens and React components
github/ GitHub provider contract and remote URL parsing
devin/ Devin provider contract and session schema
verification/ Verification policy schema and verdict evaluation
fixtures/
repositories/ Minimal repositories used by tests
docs/ Design notes
| Tool | Version used in development | Minimum |
|---|---|---|
| Node.js | 26.7.0 | 22.22.0 (required by React Router 8) |
| pnpm | 10.33.0 | 10 |
| Rust | 1.99.1 stable | 1.85 |
| OS deps | Xcode Command Line Tools on macOS; see Tauri prerequisites for Linux and Windows |
- Run
pnpm dev:desktopand open Repositories. - Choose Open Local Repository to register one repository, or Discover Folder to search a folder. Pick a maximum depth (default 4) and whether to follow symbolic links that stay inside the folder.
- Progress streams while ShiftOps searches and reads Git metadata. Cancel stops the search.
- Review the results (branch, commit, origin, working-tree counts, warnings), select repositories and click Import.
Discovery reads the filesystem and runs only a fixed list of read-only Git commands. It never runs repository code, installs dependencies or changes files. Imported repositories start as untrusted.
Open a repository and click Run first scan (or Scan / Rescan). The scanner reads manifests and configuration and records each fact with its file, line or JSON pointer, detection method and confidence:
- languages, runtimes, package managers, workspaces, lockfiles;
- frameworks, dependencies and declared scripts;
- Docker and CI configuration.
Conflicting runtime or package-manager declarations are listed explicitly.
The scanner never runs repository code and never reads secret files such as .env or .npmrc. Results are cached by commit and relevant-file content, so an unchanged repository is not rescanned.
To check what the scanner would report for any checkout, without the UI or the database:
SHIFTOPS_SCAN_PATH=/path/to/repo cargo test --manifest-path apps/desktop/src-tauri/Cargo.toml scan_rehearsal -- --ignored --nocaptureShiftOps talks to GitHub from its Rust core. Tokens are stored only in the OS keychain and are never shown again.
Device sign-in (recommended):
- Create a GitHub OAuth app (GitHub → Settings → Developer settings → OAuth Apps) and enable Device Flow. No client secret is needed.
- Copy
apps/desktop/.env.exampletoapps/desktop/.envand setVITE_GITHUB_OAUTH_CLIENT_ID. For GitHub Enterprise, also setVITE_GITHUB_HOSTandVITE_GITHUB_API_BASE_URL. - Restart
pnpm dev:desktop. - Open Integrations → GitHub → Sign in with GitHub, then enter the code on GitHub.
Fine-grained personal access token (fallback): grant access to the repositories you need, with Metadata, Contents, Pull requests and Checks set to read-only, plus organisation Members (read) to list organisations. Paste it in Integrations → GitHub. ShiftOps validates it before storing it.
Then, on Repositories, choose one of the three GitHub actions and select a repository:
- Metadata only inventories the repository without downloading it; deep analysis remains unavailable.
- Clone into managed workspace previews a new destination under a folder you explicitly approve, streams clone progress and scans the checkout after success.
- Link existing clone compares its normalized remote with the GitHub repository and requires an explicit override when they differ. Existing clones remain external and are never modified or deleted.
Repository detail lets you change trust after a confirmation, edit the display name and notes, unlink a checkout, delete a ShiftOps-managed clone (typed path, clean tree only) or forget the record. Forgetting a record never deletes checkout files. Submission Readiness derives the hackathon checklist from the current Git state, required documents, participant TODOs, validation evidence and a bounded tracked-secret review; it never marks the project Submitted automatically.
- Campaigns → New campaign: name, objective (for example "Upgrade Node.js 18 to Node.js 22"), migration type, runtime key and source/target majors, optional deadline, parallelism, and repositories picked from your real records.
- Refresh edges records inferred dependency edges where one repository's scanned manifest declares a package whose name matches another registered repository. Edges are labelled
inferredwith the matching fact as evidence; they are never presented as certain. - Compute plan runs the pure planner (
packages/core/src/planning.ts) over the latest scan evidence: classification against the goal, a 0–1 risk score with cited reasons (uncommitted changes, scan conflicts, missing lockfile, no CI, many dependents), and deterministic waves. Wave 0 holds blockers (blocked trust, no checkout, no completed scan, dependency cycles). Later waves put dependencies before dependents. High-risk, conflicted, unclassifiable or externally-dependent repositories are flagged for human review. - Apply plan & mark ready persists the plan per member and moves the campaign to
ready. - Draft task on a member builds a deterministic Devin task: repository identity, approved goal, scan evidence, scope, acceptance criteria, verification commands for Task 5, and explicit prohibitions. Its SHA-256 is stored.
- Agent Runs → Approve, then Dispatch to Devin. Dispatch requires: approval, a cleared review flag, classification
affected, a trusted repository with a local checkout, and an installed, signed-in Devin CLI. It runsdevin -p <task> --permission-mode smart --sandbox --respect-workspace-trust falsein that checkout. Cancel stops the process group.
Without a signed-in Devin CLI every step up to an approved draft still works; dispatch reports DEVIN_NOT_CONFIGURED.
Dispatch also refuses a checkout with uncommitted changes, a member whose verification is running, and a second live session for the same repository.
- Campaign detail → Verify on a member shows the verification plan derived from that checkout's own root
package.jsonand lockfile: one dependency install with lifecycle scripts disabled (pnpm install --frozen-lockfile --ignore-scripts,yarn install --frozen-lockfile --ignore-scriptsornpm ci --ignore-scripts, only when a lockfile exists), then whichever of thetypecheck,lint,build,testandcheckscripts exist, with each script body shown. - Verification runs the repository's own scripts, so it requires a trusted repository and a ticked confirmation. The plan hash covers every command and script body; if anything changed since you reviewed it, nothing runs.
- Each check records its real exit code, duration and redacted output. Failures are marked repairable only when they are a failed script (not the install, a timeout or a missing command) whose output names files inside the checkout.
- Draft repair task creates a bounded Devin task from the latest failed run (at most 2 per repository). It goes through the same Approve and Dispatch steps. When the repair session succeeds, ShiftOps re-runs the same approved plan automatically, but only if its hash is unchanged. A passed run marks the member
verified; a Devin session alone never does. - This version verifies Node.js repositories only. Other ecosystems report "no verification plan".
- The repository detail page edits a display name and notes (discovery never overwrites them), shows whether the checkout folder still exists, and changes trust only after a confirmation that states what the new level allows. Lowering trust cancels live verification and Devin work in that checkout.
- There are three separate ways to let go of a repository. Unlink checkout turns a GitHub-linked record back into metadata-only and leaves the folder alone. Delete managed files is offered only for checkouts ShiftOps cloned; it needs the exact path typed and a clean working tree. Forget record removes the ShiftOps record only. External checkouts are never deleted.
- The five import actions are on the Repositories page: Open Local Repository, Discover Folder, GitHub Metadata Only, Clone into Managed Workspace, and Link Existing Clone.
pnpm install # install all workspaces
pnpm dev:desktop # launch the desktop app (Vite + Tauri, hot reload)
pnpm dev:website # website at http://localhost:3000
pnpm dev:web # desktop frontend only, in a browser (native calls report unavailable)
pnpm format:check # Prettier
pnpm typecheck # tsc across all workspaces
pnpm lint # ESLint across the repository
pnpm test # Vitest across all workspaces
pnpm test:rust # cargo test (includes IPC tests through Tauri's mock runtime)
pnpm lint:rust # cargo clippy -D warnings
pnpm fmt:rust # rustfmt --check
pnpm check # all of the abovePrint the real environment report for this machine as JSON:
SHIFTOPS_PRINT_ENV_REPORT=1 cargo test --manifest-path apps/desktop/src-tauri/Cargo.toml environment_checks -- --nocaptureRehearse a schema upgrade on a copy of a database:
SHIFTOPS_UPGRADE_DB=/path/to/copy.db cargo test --manifest-path apps/desktop/src-tauri/Cargo.toml upgrade_rehearsal -- --ignored --nocapture| What | Location |
|---|---|
| Database | ~/Library/Application Support/dev.shiftops.desktop/shiftops.db |
| Pre-upgrade backups | ~/Library/Application Support/dev.shiftops.desktop/backups/ |
| Application log | ~/Library/Logs/dev.shiftops.desktop/shiftops.log (redacted) |
| Command run logs | ~/Library/Logs/dev.shiftops.desktop/runs/<run id>.log |
| Credentials | macOS Keychain, service dev.shiftops.desktop |
- docs/USER_MANUAL.md: step-by-step guide to using the app
- ARCHITECTURE.md: how the pieces fit together
- SECURITY.md: threat model and reporting
- CONTRIBUTING.md: workflow and standards
- AGENTS.md: rules for AI coding agents working in this repository
- PROJECT_STATE.md: what is done, what is next, and why
- CHANGELOG.md: dated record of every meaningful change
- AI_USAGE.md: which AI tools contributed what
- SUBMISSION.md: hackathon submission details