Skip to content

Arkiv 0.3.0: local SDK context

Choose a tag to compare

View all tags
@SantiagoDevRel SantiagoDevRel released this 16 Oct 21:44
· 6 commits to main since this release
arkiv--v0.3.0
89c1945
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Plugin 0.3.0 adds local SDK context for Claude Code and Codex CLI, plus the canonical installed-import check.

What's new

  • Local SDK context hooks (both hosts). At session start and on later prompts, the plugin reads the workspace's package.json, npm lockfile and installed @arkiv-network/sdk declarations, then tells the agent one category: compatible, out_of_range, not_installed, mismatch or absent. It names the supported range >=0.8.1 <0.9. It never imports project code. It makes no HTTP, TCP or DNS requests and writes no cache or identifiers. Supported on Windows and on Linux with Node 20.8+. macOS stays unmeasured.
  • Codex native manifest. The Codex package now uses .codex-plugin/plugin.json, so Codex loads its hooks. Review and trust them once with /hooks.
  • Canonical skills Arkiv-Network/skills@49c0e06 (#62). In Claude Code, the router's installed-import check runs after Write/Edit on files that import the SDK. For an SDK outside the supported range, the router proposes an explicit upgrade plan instead of adapting newer examples.
  • Skill-usage collection stays disabled.

Evidence

  • Context-only ablation, October 16. Each host ran 73 cases × 3 repetitions per arm in installed-SDK fixture workspaces, graded by a blind Opus 5.5 judge with 3 votes per answer:
    • Claude Code: 218/219 with context vs 211/219 without; 0 pairs worse, 7 better.
    • Codex CLI: 207/219 vs 204/219; 2 pairs worse, 5 better. Neither worse pair is attributable to the context.
  • 78/78 tests on Linux ARM64 and 77/77 on Windows. claude plugin validate --strict passes.
  • Installation was checked in isolated profiles:
    • Fresh public installs match the repository packages: 49 Claude files and 47 Codex files.
    • Updates from 0.2.1 succeed on both hosts.
    • Native sessions from the installed 0.3.0 packages received compatible for a 0.8.1 fixture and out_of_range for a 0.6.8 fixture on both hosts. The MCP was suppressed or mocked, so no production traffic was sent.

Update

  • Claude Code: claude plugin marketplace update arkiv, then claude plugin update arkiv@arkiv, then restart.
  • Codex CLI: codex plugin marketplace upgrade arkiv, then codex plugin add arkiv@arkiv, then start a new session and trust the Arkiv hooks once with /hooks.
Assets 2
Loading