arkaos
The Operating System for AI Agent Teams
Why this rank:Recent releaseHealthy release cadenceStrong adoption
Description
The Operating System for AI Agent Teams
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| v4.0.1 | ## 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 | High | 6/1/2026 |
| v3.78.0 | ## 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- | High | 5/30/2026 |
| v2.41.0 | ## 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 | High | 5/23/2026 |
| v2.39.0 | **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 | High | 5/13/2026 |
| 2.22.1 | Imported from npm (2.22.1) | Low | 4/21/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | High | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.1 | ## 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 | Medium | 4/20/2026 |
| v2.22.0 | ## ArkaOS v2.22.0 โ LLM Agnostic Auto-Documentor Runtime-agnostic LLM wiring for the auto-documentor that shipped in v2.21.0. **Zero model hardcoding.** Whatever runtime you have configured (Claude Code, Codex CLI, Gemini CLI, Cursor) decides the model โ ArkaOS just delegates. Owner's non-negotiable principle: > "nao quero modelos tem que ser automatico independentmente do model." ### What's new **LLMProvider Protocol** (`core/runtime/llm_provider.py`) Three providers behind one abstraction | High | 4/20/2026 |
| v2.21.0 | ## ArkaOS v2.21.0 โ Intelligence v2 Ships two cross-cutting รฉpicos that make ArkaOS measurably more intelligent with every use. ### รpico A โ Flow Marker v2 (cross-turn false positives eliminated) Amendment to ADR-2026-04-17 binding flow enforcement. Adds Layer 3: a turn-scoped marker cache that accelerates ALLOW decisions only (never a sole basis for deny, per ADR-17 invariants). - `core/workflow/marker_cache.py` โ atomic tmp+rename writes with pid-tid-uuid suffix (200-thread race safe, mul | High | 4/20/2026 |
| v2.20.1 | ## Hotfix for v2.20.0 v2.20.0 shipped with the `PreToolUse` and `Stop` hooks registered in `settings.json` but the installer never copied their `.sh` scripts to `~/.arkaos/config/hooks/`. Every `Grep`/`Read`/`Write`/`Edit` call and every session end produced a non-blocking `No such file or directory` error. If you ran `npx arkaos@latest update` after v2.20.0 was published, upgrade now: ```bash npx arkaos@latest update ``` ### Fixes - `installer/index.js`: add `pre-tool-use` and `stop` to th | High | 4/18/2026 |
| v2.20.0-beta.1 | ## Binding enforcement of the mandatory 13-phase flow First beta release of the `PreToolUse` + `Stop` hook enforcement layer for the ArkaOS mandatory 13-phase canonical flow. Ends the recurring failure mode where Claude skipped the flow in client projects. **Per ADR `2026-04-17-binding-flow-enforcement.md` โ Alternative E (hybrid).** ## What's new - `PreToolUse` hook gates **only** `Write` / `Edit` / `MultiEdit`. `Bash` / `Read` / `Grep` / `Agent` always pass (prevents deadlock). - Stateless | High | 4/17/2026 |
| v2.20.0 | ## Structural workflow enforcement The mandatory 13-phase canonical flow is now enforced across four layers: 1. **constitution.yaml** โ new NON-NEGOTIABLE rule `mandatory-flow`. 2. **SessionStart hook** โ injects the flow as `systemMessage` at system-prompt priority from turn 1. 3. **UserPromptSubmit classifier** โ on creation/implementation verbs (EN + PT), injects the full 13-phase contract as `additionalContext`. 4. **arka/SKILL.md + arka/skills/flow/SKILL.md** โ canonical spec. The 13 pha | High | 4/17/2026 |
| v2.19.2 | Classifier in UserPromptSubmit hook now detects creation/implementation requests (EN + PT) and injects [ARKA:WORKFLOW-REQUIRED]. The orchestrator must emit [arka:routing] <dept> -> <lead> before any write tool; trivial edits may opt out with [arka:trivial]. Propagates to ~/.arkaos/ and ~/.claude/skills/arka/ on install/update. | High | 4/17/2026 |
| v2.19.1 | ## Changes in v2.19.1 ### Internal refactors (QG follow-up) - `installer/migrate-user-data.js`: split the 78-line `migrateUserData` into `migrateProjects()` and `migrateEcosystems()` helpers. - `core/sync/engine.py`: document the Noneโpath coercion contract inline in `_discover_projects`. ### Installer bug fixes (from PR #37 by @marlonoliveira182) - `installer/adapters/claude-code.js`: write `statusLine` (camelCase) with `type: \"command\"` and `padding: 2`; previously `statusline` (lowercas | High | 4/17/2026 |
| v2.19.0 | ## User-data separation Move user-mutable project descriptors and ecosystems registry from the installer-managed `~/.claude/skills/arka/` into user-owned `~/.arkaos/`. The installed skill directory becomes strictly read-only. ### What moved | Concern | New canonical path | |---|---| | Project descriptors | `~/.arkaos/projects/<slug>.md` or `~/.arkaos/projects/<slug>/PROJECT.md` | | Ecosystem registry | `~/.arkaos/ecosystems.json` | ### Migration Runs automatically on `npx arkaos@latest upda | High | 4/17/2026 |
| v2.18.1 | ## Security fix v2.17.5 and v2.18.0 shipped with private client data embedded in the tarball. This release removes it. ### Removed - `arka/skills/fovory/` (internal business) - `arka/skills/rothbard100/` (client project) - `arka/skills/platform-arka/` (internal) - `knowledge/ecosystems.json` content (client names, tech stacks, squads) ### Actions taken - v2.18.0 has been unpublished from npm. - `.gitignore` and `.npmignore` now block these paths so the leak cannot recur. - `ecosystems.json` s | High | 4/17/2026 |
| v2.18.0 | ## Fix: MCP activation regression from v2.17.5 ### What was broken After v2.17.5, projects ended up with only 4 MCPs active instead of 6-10, and department commands (`/dev`, `/mkt`, `/brand`, etc. exposed via `arka-prompts` MCP) disappeared from every project. ### Root cause `config/mcp-policy.yaml` left most registry MCPs (`arka-prompts`, `obsidian`, `laravel-boost`, `serena`, `memory-bank`, `sentry`) unclassified for common stacks. They fell through to the AI decider which, with `call_ai=Non | High | 4/17/2026 |
| v2.17.5 | ## Fixed - KB Cache TTL eviction bug: _evict_expired() now called on every store() to proactively evict expired entries. Default TTL raised 30min โ 90min, max_entries 50 โ 150. - conclave/SKILL.md: Added compact 20-advisor table inline to fix test assertion. | High | 4/17/2026 |
| v2.17.4 | Sprint 10: Lazy-Load Skills โ All skill SKILL.md files trimmed to โค120 lines. Thin orchestrators + references/ subdirectory. 12 project-specific skills removed from shared repo. | High | 4/16/2026 |
| v2.17.3 | ## Sprint 9 Complete โ 4 items delivered ### Memory System - **SessionStart hook**: Now calls `build_resume_context()` to resume session memory on startup - **L9 SessionContextLayer**: New layer in Synapse that re-injects session context ### Quality Gate L6 โ Real State - `QualityGateLayer.compute()` now queries real QG state via `list_pending()` and `list_approved()` - Previously used hardcoded placeholder data ### KB Cache Auto-Inject - `KnowledgeRetrievalLayer.compute()` now calls `kb_cach | High | 4/16/2026 |
| v2.17.2 | ## Sprint 8 Complete: The Forge Integration ### New Features - **ForgeOrchestrator** โ 10-step planning flow with complexity-based model routing - **ForgeTaskDispatcher** โ Multi-runtime abstraction for LLM dispatch - **ClaudeCodeForgeDispatcher** โ Task tool integration with model routing (haiku/sonnet/opus) ### Bug Fixes - Fixed `_enforced_phases` initialization order bug - Fixed `enumerate(range())` int-iterable bug - Added missing `_step9_render()` method - Removed dead code in constitut | High | 4/16/2026 |
| v2.17.1 | ## Patch โ Persistent ArkaOS identity & subagent context ### Fixed - **#38** Squad routing faded after first turn โ added persistent \`[arka:route]\` reminder injected every UserPromptSubmit - **#39** KB chunks injected silently โ \`[arka:route]\` now requires explicit citation when \`[knowledge:N chunks]\` is present, and Obsidian fallback when absent - Mirror fix in PowerShell hook (Windows parity) ### Added - **#41** \`ContextCompactor\` (rule-based, zero-LLM) for building subagent handoff | Medium | 4/14/2026 |
| v2.17.0 | ## Highlights ArkaOS v2.17.0 ships the **Project Runtime Sync** umbrella โ `/arka update` now brings all 81 projects to the current core behavior, not just MCP configs. Every project gets current CLAUDE.md, rules, hooks, constitution, baseline agents, and optimized MCP loading. **Expected impact:** per-session MCP context ~93k โ target <25k tokens via deferred-loading; every project now runs against current-version rules instead of whatever version it was onboarded at. ## Sub-features ### Co | Medium | 4/12/2026 |
| v2.16.1 | ## Fixed - Descriptor syncer crashed with `IndexError: list index out of range` when a project descriptor had a scalar `stack:` value instead of a YAML list. Affected `lora-tester` and `purz-comfyui-workflows`. The syncer now coerces scalar strings to single-element lists, tolerates `None`, and drops empty tokens during normalization. The next `/arka update` self-heals existing malformed descriptors. ## Tests 2244/2244 passing, 3 new regression tests covering scalar stack, list coer | Medium | 4/12/2026 |
| v2.16.0 | ## Token Optimization Campaign Four merged PRs focused on reducing token consumption while preserving quality. ### Features **Lazy-load skills (PR 2)** - 10 heavyweight orchestrator skills split into thin SKILL.md (โค120 lines) + on-demand `references/` - Total 4,408 โ 823 lines in top-level SKILL.md files (81% reduction) - Canonical source established in repo for 7 previously-orphan skills - Installer extended to scan `arka/skills/<name>/` pattern **Model routing (PR 3)** - New \`model\` fie | Medium | 4/12/2026 |
| v2.15.0 | ## ArkaOS v2.15.0 โ The Sync Engine ### What's New **Hybrid Sync Engine** โ `/arka update` now actually works. Python handles deterministic operations, AI handles intelligent updates. #### Core Module: `core/sync/` - **8 Python modules** โ schema, manifest, discovery, mcp_syncer, settings_syncer, descriptor_syncer, reporter, engine - **Feature Registry** โ `core/sync/features/*.yaml` โ add a YAML file, all ecosystems get the feature on next sync - **CLI entry point** โ `python -m core.sync.en | Medium | 4/11/2026 |
| v2.14.0 | ## The Forge โ Multi-Agent Planning Engine ArkaOS v2.14.0 introduces **The Forge** (`/forge`), an intelligent planning engine that scales agent count based on task complexity. ### What's New **Core Engine** (`core/forge/`) - **Complexity Scorer** โ 5-dimension analysis (scope, dependencies, ambiguity, risk, novelty) with weighted scoring and automatic tier determination (shallow/standard/deep) - **Explorer Agents** โ 1-3 parallel explorers with differentiated lenses: Pragmatic, Architectural, | Medium | 4/11/2026 |
| v2.13.0 | ## v2.13.0 ### Workflow State Tracker โ Governance Enforcement Foundation ArkaOS now tracks workflow phases, detects governance violations, and surfaces them in real time. This is SP1 of the Workflow Enforcement system (WS3). **New module: `core/workflow/state.py`** - `init_workflow()` โ start tracking a workflow with named phases - `update_phase()` โ mark phases as pending/in_progress/completed/skipped - `set_branch()` / `add_violation()` โ record branch and violations - `is_phase_completed( | Medium | 4/11/2026 |
| v2.12.0 | ## v2.12.0 ### MCP Infrastructure โ Now Available to All Users The MCP management system (registry, profiles, scripts, arka-prompts server) was previously only available on the maintainer's machine. It is now committed to the repository and deployed automatically during install and update. **What's included:** - **MCP Registry** (`mcps/registry.json`): 22 MCP server definitions with categories, descriptions, and environment variable requirements - **10 Profiles**: base, laravel, nuxt, vue, re | Medium | 4/11/2026 |
| v2.11.0 | ## v2.11.0 ### Windows Native Support (PR #35 by @marlonoliveira182) ArkaOS now runs natively on Windows alongside macOS and Linux. One unified installer (`npx arkaos install`) handles all platforms automatically. - 13 new Windows-native files: 5 PowerShell hooks, statusline, CLI wrapper, env-setup, dashboard launcher - `installer/platform.js` centralizes all platform detection - sqlite-vss โ sqlite-vec migration (sqlite-vss had no Windows wheels) - Installer now deploys 243 sub-skills + 19 a | Medium | 4/11/2026 |
| v2.10.1 | ## v2.10.1 โ Python Venv Standardization + Scheduler Auto-Deploy ### Bug Fix: PEP 668 / Homebrew Python Mismatch Fixes a critical issue where `npx arkaos update` silently failed to install Python dependencies on modern macOS (Homebrew) and Ubuntu 23.04+ systems due to PEP 668 `externally-managed-environment` restrictions. **Root cause:** The installer mixed system `python3` with the ArkaOS venv Python, and `pip install` was rejected by PEP 668 without `--break-system-packages`. **Solution:** | Medium | 4/9/2026 |
| v2.10.0 | ## Cognitive Layer โ ArkaOS Learns, Dreams, and Researches The biggest feature release since v2.0. ArkaOS now has three cognitive capabilities that make it smarter every day: ### Institutional Memory (Dual-Write) - **Obsidian + Vector DB** simultaneous persistence - Knowledge entries with confidence scoring and cross-project applicability - Semantic search finds relevant prior solutions even with different wording - Raw session captures during the day, curated knowledge at night ### Dreaming | Medium | 4/9/2026 |
| v2.9.0 | ## ArkaOS v2.9.0 โ ComfyUI Ecosystem & LoRA Tester ### New Skills - **`/comfyui`** โ Full ComfyUI ecosystem orchestrator with 2 specialized squads: - **ComfyUI Core** (6 agents): Pipeline Architect, Workflow Engineer, Node Researcher, Model Specialist, Automation Engineer, QA Tester - **Hollywood Cinematographic Production** (10 agents): Director, Cinematographer, Screenwriter, Art Director, VFX Supervisor, Colorist, Editor, Sound Designer, Motion Graphics, Producer - 7 production-ready | Medium | 4/8/2026 |
| v2.8.0 | ## ArkaOS v2.8.0 โ Branded CLI Experience ### New Features - **SessionStart hook** โ branded ARKA OS greeting displayed every time Claude Code opens (uses `systemMessage` protocol for guaranteed display) - **CwdChanged hook** โ auto-detects ecosystem and stack when switching projects, injects squad routing context - **CLI wrapper (`arka-claude`)** โ ANSI-colored branded greeting before Claude launches - **Custom Output Style** โ `~/.claude/output-styles/arkaos.md` for ArkaOS personality - **Mo | Medium | 4/8/2026 |
| v2.7.0 | ## ArkaOS v2.7.0 โ Consistency Audit Major consistency fixes across the entire ArkaOS ecosystem. 30K users depend on this being right. ### Fixes 1. **Quality Gate in ALL ecosystem skills** โ Constitution mandates QG on every workflow, but only `/dev` had it. Now all 9 ecosystem skills (ClubeFashion, Fovory, EDP, Rockport, Marlon, ZugaTV, Rothbard100, Cascais24Horas, WizardingCode) have explicit Quality Gate with Marta/Eduardo/Francisca review. 2. **Context Verification mandate** โ NEW NON-NE | Medium | 4/8/2026 |
| v2.6.0 | ## ArkaOS v2.6.0 โ Update & Sync System ### New Feature: `/arka update` AI-powered sync command that detects version drift and updates all project configurations automatically. **What it does:** - Detects when ArkaOS core has been updated (`npx arkaos update`) - Synapse hook shows `[arka:update-available]` on next session - `/arka update` dispatches 4 parallel subagents to sweep: - **Ecosystem Skills** (8 SKILL.md files) โ agent types, workflows, squad roles - **Project Descriptors** (20+ | Medium | 4/8/2026 |
| v2.5.3 | ## What's New ### Scheduling Awareness 10 department skills now include scheduling examples with `/loop` and `/schedule`, marked with โฐ. Departments: `/dev` (3), `/ecom` (2), `/brand` (1), `/ops` (2), `/strat` (2). ### Google Gemini (Nano Banana) โ Primary Image Provider - 3 models: Nano Banana 2 (fast), Nano Banana Pro (professional), Nano Banana (speed) - Up to 4K resolution, search grounding, thinking mode - Set as primary in image-generation routing chain - OpenAI reassigned to audio-only | Medium | 4/6/2026 |
| v2.5.2 | ## What's New ### Scheduling Awareness 10 department skills now include scheduling examples with `/loop` and `/schedule`. Each schedulable workflow is marked with โฐ and includes ready-to-use commands. **Examples:** - `/loop 30m check open PRs and summarize any that need review` - `/schedule daily at 8am โ store health check: uptime, broken links, price errors` - `/loop 15m check N8N workflow executions, flag any failures` - `/schedule weekly โ competitor pricing check` **Schedulable departmen | Medium | 4/6/2026 |
| v2.5.1 | ## What's New ### Computer Use Integration 5 departments gain computer-use awareness with `[COMPUTER]` steps across 11 existing skills. Enables controlling native macOS apps, iOS Simulator, and GUI-only tools. **Installer:** opt-in prompt with restriction warnings (macOS only, Pro/Max plan required). **Computer-aware departments:** `/dev`, `/ecom`, `/brand`, `/ops`, `/strat` **2 new computer-only commands:** - `/dev app-test` โ build, launch, and click through a native app, screenshot each s | Medium | 4/6/2026 |
| v2.5.0 | ## What's New ### /platform-arka โ ArkaOS Self-Management Ecosystem ArkaOS can now manage its own development as a WizardingCode internal project. Full 9-role product team with commands for features, fixes, releases, self-auditing, and auto-evolution. - `/platform-arka status` โ project health - `/platform-arka audit` โ self-analysis (code quality, skill gaps, agent DNA) - `/platform-arka evolve` โ propose and implement improvements - `/platform-arka release` โ semi-auto release with confirmat | Medium | 4/6/2026 |
| v2.4.4 | Fix: API crash on startup (broken upload placeholder removed) | Medium | 4/6/2026 |
| v2.4.3 | Silent update: npx arkaos update preserves config, no prompts | Medium | 4/6/2026 |
| v2.4.2 | Updated CONSTITUTION.md and CONTRIBUTING.md | Medium | 4/6/2026 |
| v2.4.1 | Fix: robust dashboard startup with HTTP health check retry (10s timeout instead of 2s sleep) | Medium | 4/6/2026 |
| v2.4.0 | ### Interactive Installer `npx arkaos install` now asks everything: - **Language**: English, Portuguรชs, Espaรฑol, Franรงais, Deutsch, ไธญๆ, ๆฅๆฌ่ช, etc. - **Market/Country**: free text (no hardcoded defaults) - **Role**: Developer, Founder, Marketing, Product, Designer, Consultant - **Directories**: projects dir, Obsidian vault path, ArkaOS data dir - **Features**: dashboard, knowledge DB, transcription (optional) - **API Keys**: OpenAI, Google, fal.ai (optional, can configure later) Shows summary a | Medium | 4/6/2026 |
| v2.3.6 | Fix: file upload working (PDFs, audio), text paste ingest, all 4 input modes functional | Medium | 4/6/2026 |
| v2.3.5 | Fix: npx arkaos index auto-detects vault, CORS dynamic ports | Medium | 4/6/2026 |
| v2.3.4 | Fix: CORS accepts any localhost port for dynamic dashboard ports | Medium | 4/6/2026 |
| v2.3.3 | Fix: API and UI no longer get same port | Medium | 4/6/2026 |
| v2.3.2 | Fix: dynamic ports (no more address-in-use), auto-install dashboard deps, opens browser | Medium | 4/6/2026 |
| v2.3.1 | Fix: include scripts/, config/, arka/, dashboard/ in npm package. Dashboard and CLI tools now work via npx. | Medium | 4/6/2026 |
| v2.3.0 | ### Complete Installer Rewrite The installer now does everything a non-technical user needs: ``` npx arkaos install ``` 12 steps: 1. Create directories 2. Detect v1 โ offer migration 3. Check Python 3.11+ 4. **Install ALL Python dependencies** (core, vector DB, ingest, dashboard, whisper) 5. Copy configuration (constitution, standards) 6. Install hooks with real paths to Synapse bridge 7. Configure runtime (Claude Code, Codex, Gemini, Cursor) 8. **Install /arka skill to Claude Code** (the mai | Medium | 4/6/2026 |
| v2.2.2 | ### Fixed - **/arka command restored** โ main orchestrator SKILL.md updated with v2 data (65 agents, dashboard, knowledge, personas) - YouTube ingest: Python API directly (no Deno dependency), 4-phase progress, pre-flight check - SQLite thread safety: thread-local JobManager for ingest workers - Non-blocking ingest form: submit multiple URLs without waiting - Knowledge ingest UI: 4 input modes (URL, File drag&drop, Text paste, Research) ### Added - SQLite job queue (`~/.arkaos/jobs.db`) replaci | Medium | 4/6/2026 |
| v2.2.1 | ### Added - WebSocket real-time ingest progress (replaces polling) - 4 input modes: URL, File (drag & drop), Text paste, Research - Task persistence across page navigation (localStorage + API restore) - Batched embedding (fixes 85% stuck issue) - Comprehensive docs: 9 files, 3636 lines with real examples - API key management (OpenAI, Google, fal.ai) - Knowledge ingest UI redesign ### Fixed - Embedding no longer blocks at 85% (batch of 10) - Active ingest persists when navigating away and back | Medium | 4/5/2026 |
| v2.2.0 | ## ArkaOS v2.2.0 ### Added - **API Key Management** โ `npx arkaos keys` for OpenAI, Google, fal.ai keys - **Dashboard Settings** page with key management UI - **Comprehensive Documentation** โ 9 docs, 3636 lines with real examples - Getting Started, Commands, Departments, Architecture, Skill Standard - API Reference, Migration Guide, Use Cases (12 real scenarios), Personas Guide - **Budget Tracking** wired โ Synapse + knowledge ingest register tokens automatically - **Agent Detail Redesign* | Medium | 4/5/2026 |
| v2.1.2 | ### Added - Budget tracking wired: Synapse bridge + knowledge ingest register token usage automatically - Personas navbar button aligned to right ### Fixed - Budget data now shows real usage per department in dashboard Full changelog: https://github.com/andreagroferreira/arka-os/blob/master/CHANGELOG.md | Medium | 4/5/2026 |
Dependencies & License Audit
Loading dependencies...
Similar Packages
@neyugn/agent-kitsUniversal AI Agent Toolkit - Skills, Agents, and Workflows for any AI coding assistant0.5.8
tokentracker-cliToken usage tracker for AI agent CLIs (Claude Code, Codex, Cursor, Kiro, Gemini, OpenCode, OpenClaw, Hermes, GitHub Copilot)v0.42.0
More in Frameworks
langchainThe agent engineering platform
deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of ta
tqdmFast, Extensible Progress Meter
simBuild, deploy, and orchestrate AI agents. Sim is the central intelligence layer for your AI workforce.