# arkaos

> The Operating System for AI Agent Teams

- **URL**: https://www.freshcrate.ai/projects/arkaos
- **Author**: WizardingCode
- **Category**: Frameworks
- **Latest version**: `v4.0.1` (2026-06-01)
- **License**: MIT
- **Source**: https://github.com/andreagroferreira/arka-os
- **Homepage**: https://arkaos.dev
- **Language**: Python
- **GitHub**: 4 stars, 2 forks
- **Registry**: npm (`arkaos`)
- **Tags**: `agents`, `ai`, `claude`, `codex`, `cursor`, `gemini`, `npm`, `orchestration`, `saas`

## Description

The Operating System for AI Agent Teams

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v4.0.1` | 2026-06-01 | High | ## Documentation overhaul  Eliminates severe documentation drift by making every documented number generated from the repo, never hand-typed.  ### Source of truth - `scripts/tools/docs_stats.py` — canonical counter (agents/depts/skills/ADRs/tests) - `tests/python/test_docs_consistency.py` — locks doc numbers to the repo in CI - `scripts/bench/` — reproducible benchmark harness → `benchmarks/results.{json,md}`  ### New documentation - **`wiki/`** — 29 user-facing pages: getting-started, core conc |
| `v3.78.0` | 2026-05-30 | High | ## Frontend UI/UX Squad — Tooling + KB-first Enrichment  ### Tooling on install + update - **Magic MCP** (`@21st-dev/magic`) — frontend-category, env-gated by `${MAGIC_API_KEY}`, wired into nuxt/vue/react/nextjs/full-stack profiles (mandatory for frontend UI/UX). - New `installer/frontend-tooling.js` — prompts for the key when missing (headless-safe), registers Magic at Claude **user scope**, auto-runs the **Motion AI Kit** idempotently (one-time marker, no 180s re-run per update). - `ui-ux-pro- |
| `v2.41.0` | 2026-05-23 | High | ## What's new  **Hard Enforcement default** — `hooks.hardEnforcement = true` is now the default for fresh installs and unset configs. Explicit user `false` is preserved.  PR19 of 3 from the discipline roadmap (PR18 KB-first soft block already shipped; PR20 Dreaming → Agent loop is next).  ## Ships  - `core/governance/enforcement_telemetry.py` — line-streamed JSONL summarizer over `~/.arkaos/telemetry/enforcement.jsonl`. Period filters (today/week/month/all), malformed-line tolerant, zero-divisio |
| `v2.39.0` | 2026-05-13 | High | **Cumulative npm publish target** for the Conclave Phase 5 batch (PR10–PR17).  ## PR17: Pre-publish pack-safety fix  Pre-publish safety grep on the v2.38.0 batch caught three issues in the npm tarball that would have leaked private data exactly the way v2.18.0 did. Halted that publish, fixed here.  ### Findings  1. **CRITICAL** — `README.md:317` listed a real client name (`/edp → EDP`). The three lines above it were already sanitized (ClientRetail, ClientCommerce, ClientFashion). This one was mi |
| `2.22.1` | 2026-04-21 | Low | Imported from npm (2.22.1) |
| `v2.22.1` | 2026-04-20 | High | ## ArkaOS v2.22.1 — Polish release  Single coherent polish pass addressing all 10 non-blocking observations from the v2.21.0 and v2.22.0 Quality Gate reviews. No new features; cleaner internals, better coverage, deduped primitives.  ### What changed  **Shared helper** - `core/shared/safe_session_id.py` — 6 modules now share a single `SAFE_SESSION_ID_RE` allowlist (`flow_enforcer`, `marker_cache`, `research_gate`, `kb_cache`, `auto_documentor`, `auto_doc_worker`). 100% coverage, 33 tests locking |
| `v2.22.1` | 2026-04-20 | High | ## ArkaOS v2.22.1 — Polish release  Single coherent polish pass addressing all 10 non-blocking observations from the v2.21.0 and v2.22.0 Quality Gate reviews. No new features; cleaner internals, better coverage, deduped primitives.  ### What changed  **Shared helper** - `core/shared/safe_session_id.py` — 6 modules now share a single `SAFE_SESSION_ID_RE` allowlist (`flow_enforcer`, `marker_cache`, `research_gate`, `kb_cache`, `auto_documentor`, `auto_doc_worker`). 100% coverage, 33 tests locking |
| `v2.22.1` | 2026-04-20 | High | ## ArkaOS v2.22.1 — Polish release  Single coherent polish pass addressing all 10 non-blocking observations from the v2.21.0 and v2.22.0 Quality Gate reviews. No new features; cleaner internals, better coverage, deduped primitives.  ### What changed  **Shared helper** - `core/shared/safe_session_id.py` — 6 modules now share a single `SAFE_SESSION_ID_RE` allowlist (`flow_enforcer`, `marker_cache`, `research_gate`, `kb_cache`, `auto_documentor`, `auto_doc_worker`). 100% coverage, 33 tests locking |
| `v2.22.1` | 2026-04-20 | High | ## ArkaOS v2.22.1 — Polish release  Single coherent polish pass addressing all 10 non-blocking observations from the v2.21.0 and v2.22.0 Quality Gate reviews. No new features; cleaner internals, better coverage, deduped primitives.  ### What changed  **Shared helper** - `core/shared/safe_session_id.py` — 6 modules now share a single `SAFE_SESSION_ID_RE` allowlist (`flow_enforcer`, `marker_cache`, `research_gate`, `kb_cache`, `auto_documentor`, `auto_doc_worker`). 100% coverage, 33 tests locking |
| `v2.22.1` | 2026-04-20 | High | ## ArkaOS v2.22.1 — Polish release  Single coherent polish pass addressing all 10 non-blocking observations from the v2.21.0 and v2.22.0 Quality Gate reviews. No new features; cleaner internals, better coverage, deduped primitives.  ### What changed  **Shared helper** - `core/shared/safe_session_id.py` — 6 modules now share a single `SAFE_SESSION_ID_RE` allowlist (`flow_enforcer`, `marker_cache`, `research_gate`, `kb_cache`, `auto_documentor`, `auto_doc_worker`). 100% coverage, 33 tests locking |

## Dependency audit

- **Score**: 81/100
- **Total deps**: 19
- **Resolved**: 7
- **Unresolved**: 12
- **License conflicts**: 0
- **Warnings**: 3
- **Scanned**: 2026-05-18

## Citation

- HTML: https://www.freshcrate.ai/projects/arkaos
- Markdown: https://www.freshcrate.ai/projects/arkaos.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/arkaos/deps

_Generated by freshcrate.ai. Indexes npm releases for AI-agent ecosystem packages._