Description
The Operating System for AI Agent Teams
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 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.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