This repository is the in-progress development of 4neverCompany OS. No version, beta, or release has been published. The code, documentation, architecture decisions, brief, and commit history are a live snapshot of ongoing exploration — they will change, sometimes substantially, without notice. Do not depend on any of it for production use. There is no support, no SLA, no guarantee of compatibility between commits. A permanent open-source license will be selected before v1.0; until then see
LICENSE— source-available for evaluation only.
A packaged desktop workspace that bundles Paperclip (agent-team control plane), Hermes Agent (orchestrator), and the BMAD Method (default methodology) into a single, locally-installable product. Two fixed persona agents — Dev on Claude Code and Frontend Designer on Antigravity CLI — spawn at project start; every other persona is dynamic, spawned on demand via a featured BMad Builder UI panel with explicit persistent-vs-ephemeral lifecycle choice. Agents talk on a liberal pub/sub bus; Hermes intervenes only when chatter happens without forward motion on artifacts, code, or stories.
| Milestone | State |
|---|---|
| Planning (Analyst → PM → Architect → Epics → Readiness) | ✅ Complete (Readiness verdict: READY) |
| M0 — monorepo + CI baseline + Tauri spike + LICENSES/pinned-versions audits | ✅ Shipped (audits remain DRAFT pending review) |
| M1 first batch — credential storage + wizard auth flow + Zellij adapter | ✅ Shipped |
M1 visual baseline — @c4n/ui-tokens + wizard restyle + AppShell |
✅ Shipped |
| M1 spawn pipeline (Stories 1.12 – 1.18) | ⏳ In progress |
| M2 — Frontend Designer (Antigravity) + BMad Builder UI | ⏳ Not started |
| M3 / M4 / M5 | ⏳ Not started |
Latest substantive log: see commit history. Local validation gates (prettier, eslint, tsc × 14 packages, vitest, cargo fmt, cargo clippy, vite build × 2 apps) pass on every commit.
These are the source-of-truth and must not be modified without raising a new version and getting approval:
docs/4neverCompany_OS_Brief.md— strategic vision (v0.6).docs/4neverCompany_OS_Build_Plan.md— M0–M5 phasing (v0.1).docs/HANDOFF.md— operator protocol.
Generated by the BMAD planning chain (Analyst → PM → Architect → Epics & Stories):
_bmad-output/planning-artifacts/briefs/brief-c4n-4neverCompanyOS-2026-05-25/brief.md— Analyst brief._bmad-output/planning-artifacts/prds/prd-c4n-4neverCompanyOS-2026-05-25/prd.md— PRD (37 FRs)._bmad-output/planning-artifacts/architecture.md— Architecture (15 decisions, complete monorepo tree)._bmad-output/planning-artifacts/epics.md— Epics & Stories (5 epics, ~60 stories)._bmad-output/planning-artifacts/implementation-readiness-report-2026-05-26.md— Readiness verdict: READY.
This repo is a single pnpm workspace + Cargo workspace per Architecture §6:
apps/
desktop/ Tauri desktop shell (hosts Paperclip's React UI + injects workspace panels)
wizard/ First-run wizard (separate Tauri window)
docs/ VitePress documentation site (deployed to Cloudflare Pages)
packages/ TypeScript packages
core/ types + Zod schemas + Glossary (upstream-agnostic)
bus-client/ TS client for the message bus
workflow-engine/ BMAD YAML executor
persona-sync/ vault ↔ tool-config sync (claude.md, agy.md, agent.md)
progress-signal/ artifact/code/story-state signal subscribers
stall-detector/ rolling-window stall algorithm
telemetry/ per-persona token-cost telemetry
vault-layout/ vault directory layout spec implementation
credential-storage/ TS facade over the keychain Rust crate
github-sync/ M5 — opt-in GitHub sync
supermemory-client/ M5 — opt-in Supermemory wrapper
crates/ Rust crates consumed as Tauri sidecars
zellij-adapter/ spawn / supervise Zellij sessions (D-2)
bus-relay/ bus over IPC + WebSocket (D-3)
persona-supervisor/ wrap each persona process; stdout/stderr capture (D-11)
platform-fs/ file-watching (Rust-side, replaces chokidar on Windows)
vault-scoping/ per-persona vault write logger (D-7)
services/ vendored upstreams (Paperclip, Hermes, BMAD) — pinned per docs/pinned-versions.md
tests/ workspace-level E2E (Playwright at M4+) + manual scenarios
docs/ authoritative + generated docs (see above)
scripts/ dev / build / pin-rebase helpers
_bmad/ BMAD framework install
_bmad-output/ BMAD-produced artifacts (planning chain)
.github/workflows/ CI matrix (lint + typecheck + test on Win/Mac/Linux)
spikes/ throwaway exploratory code (gitignored)
-
Install pre-reqs:
- Node.js ≥ 22.13 (required by pnpm 11's
node:sqlitebuiltin) - pnpm 11.3.0 (pinned; install via
npm i -g pnpm@11.3.0) - Rust 1.90.0 stable (managed via
rust-toolchain.toml) - Visual Studio 2022 Build Tools with the Windows 11 SDK (10.0.28000.0 or newer) component installed
- Microsoft Edge WebView2 Runtime (Evergreen)
- GitHub CLI (
gh) — for upstream license/version checks
- Node.js ≥ 22.13 (required by pnpm 11's
-
Clone:
git clone <repo-url> 4nevercompany-os cd 4nevercompany-os
-
Install:
pnpm install
-
Load the VS Developer environment at the start of every Tauri-touching shell session:
& 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\Tools\Launch-VsDevShell.ps1' -Arch amd64 -HostArch amd64 -SkipAutomaticLocation
(This populates LIB + INCLUDE so Tauri's Rust crates can link.)
-
Run desktop in dev:
pnpm dev:desktop
-
Run the test suite:
# TypeScript / JavaScript (vitest across all packages) pnpm test # Rust (cargo test across all crates) pnpm rust:test # Linting, formatting, and type-checking (same gates as CI) pnpm lint pnpm format pnpm typecheck pnpm rust:fmt pnpm rust:clippy
Integration tests that require optional system tools (Zellij, supervisor binary) are marked
#[ignore]in Rust and skipped by default — run them withcargo test --workspace -- --ignoredonce those tools are installed.
This project is NOT affiliated with, endorsed by, or sponsored by any of the upstream component owners — Anthropic, Google, Obsidian, Microsoft, JetBrains, BMad Code LLC, NousResearch, or anyone else listed in LICENSES.md. It is an independent integration that bundles or integrates with their tools per each tool's published terms.
- "Claude" and "Claude Code" are products and trademarks of Anthropic PBC.
- "Antigravity CLI" and "Gemini" are products and trademarks of Google LLC.
- "Obsidian" is a product and trademark of Dynalist Inc.
- "BMAD Method" is © 2025 BMad Code, LLC.
- All other product names, trademarks, and logos referenced in this repository belong to their respective owners.
See LICENSE for this project's source-code license notice. Summary while pre-release: source-available for reading, forking on GitHub, opening issues, and local evaluation only. Redistribution, production use, commercial deployment, derivative products, and use of the project's name / brand are not permitted until a final license (intended to be a permissive OSS license such as MIT or Apache-2.0) is published at v1.0.
For the per-component audit of bundled and integrated third-party components (Tauri, React, Paperclip, Hermes, BMAD, Zellij, Claude Code, Antigravity, Obsidian, etc.) — including redistribution and commercial-use terms for each — see LICENSES.md. All Tier-1 bundled components are permissive (MIT / Apache-2.0 / BSD-family / WebView2 Distribution Agreement). Tier-2 integrated tools (Claude Code, Antigravity CLI, Obsidian, Supermemory, GitHub) are installed by the first-run wizard via each tool's own installer; the user authenticates with their own credentials. Canonical attribution copy lives in packages/core/src/attribution.ts (Story 1.19).
Adapter, plugin, persona, or BMAD module that is general-purpose is offered upstream when ready. Maintaining in-tree forks is the exception, not the default. See LICENSES.md and docs/architecture-alternatives-evaluation.md for the policy context.
Open a GitHub issue on this repository. Because this is pre-release, there is no public roadmap commitment, no time-bound support, and no SLA on issue responses. Code review and architectural feedback are welcome.