The Universal Agent Toolkit

One API across Agents; only the id changes. Connect to one Agent, or coordinate many, through the same TypeScript surface.

npm i @rivus/agent-kit Get started
detect.ts@rivus/agent-kit
import { detectAgents } from "@rivus/agent-kit/discovery";const found = (await detectAgents(platform)).find((i) => i.agent === "claude-code");
output
agent
claude-code
status
runnable
auth
logged-in
version
…
Agent

21 public entries · 2 packages · 5 zero-dependency entries · TypeScript · MIT · 0.23.0

The layer between your tools and every Agent

Tools talk to agent-kit; agent-kit talks to each Agent through a provider. A new Agent means a new provider, not a rewrite of your tool.

Your tools
Toolkit
Connection · agent-kit
Coordination · agent-kit-collab
Providers
+ your Agent

Built with agent-kit

Open-source projects running on agent-kit today.

Sample data

Lin Yue

presence.local/status

Claude Code · working
Codex · idle

Today 48.2M tokens

agent-presence

Agents running on your machine, and their token usage, shown in a Feishu signature preview.

agent-presence on GitHub

Sample data

Fix the failing date test

ReviewAgent Claude Code

  • Tests pass
  • Diff reviewed
  • Description filled
PR #128

agent-task-loop

Agents taken through task execution, review, rework and pull-request handoff.

agent-task-loop on GitHub

Built something on agent-kit? Add it here →

Connection and coordination

agent-kit connects to each Agent; agent-kit-collab coordinates many. Every entry is bundled and size-checked on its own, and runs in Node, the browser or a hook process.

Read

Hook into

  • /harness/eventsHook payloads as lifecycle phases8.2 KBno deps
  • /harnessHook and skill install with a ledger85.1 KB
  • /acpAgent sessions over ACP44.8 KB

Utilities

  • /redactHome paths and secrets masked1.3 KBno deps

agent-kit-collab Coordination

  • /process-lockOne running instance per machine7.0 KB
  • /leaseOne owner per task, with fencing tokens11.4 KB
  • /lanesOne turn per key, under a global cap2.2 KB

npm i @rivus/agent-kit · npm i @rivus/agent-kit-collab

compressed size budget, checked in CI

Built-in providers

Today's built-in coverage. Any other Agent can join as a provider, checked by the same conformance tests.

✓ supported · – not yet

AgentDetectHooksInstallSessionsUsageACP
claude-codesupportedsupportedsupportedsupportedsupportedsupported
codexsupportedsupportedsupportedsupportedsupportedsupported
dshsupportednot supportednot supportedsupportedsupportedsupported
cursorsupportedsupportedsupportednot supportednot supportednot supported
gemini-clisupportedsupportedsupportedsupportedsupportedsupported
groksupportedsupportedsupportedsupportedsupportedsupported
opencodesupportedsupportedsupportedsupportedsupportedsupported
pisupportedsupportedsupportedsupportedsupportednot supported
zcodesupportedsupportedsupportednot supportedsupportednot supported
+ your Agent, as a provider
Get startedAPI reference