KeiSei84
e4980f6ad7
Some checks are pending
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / preflight (push) Waiting to run
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / vps-smoke (push) Waiting to run
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:frustration-matrix,kei-frustration-loop,kei-skill-importer,kei-projects-index,kei-projects-watcher,kei-gdrive-import,kei-leak-matrix,kei-skills,kei-gateway,kei-cron-scheduler,kei-export-trajectories,kei-backend-daytona,kei-d… (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-compute-baremetal,kei-compute-vultr,kei-compute-linode,kei-compute-digitalocean,kei-svc-systemd,kei-llm-bridge-mlx name:hosted-sleep-compute]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-diff,kei-scheduler,kei-watch,kei-prune,kei-discover,kei-brain-view,kei-hibernate,kei-ledger-sign,kei-fork name:wave13-15]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-git-gitea,kei-git-forgejo,kei-git-gitlab,kei-git-bitbucket,kei-memory-sled,kei-memory-redis,kei-memory-postgres,kei-memory-sqlite,kei-auth-google,kei-auth-apple,kei-auth-magiclink,kei-auth-webauthn,kei-notify-slack,kei-n… (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-ledger,kei-migrate,kei-changelog,kei-memory,kei-store,kei-conflict-scan,kei-refactor-engine,kei-graph-check,kei-shared,kei-dna-index,kei-pet name:core]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-machine-probe,kei-llm-ollama,kei-llm-llamacpp,kei-llm-mlx,kei-llm-router,kei-model name:llm-stack]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-router,kei-sage,kei-task,kei-chat-store,kei-crossdomain,kei-search-core,kei-content-store,kei-social-store,kei-curator,kei-auth,kei-artifact name:mcp-lbm]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:keisei,kei-forge,kei-runtime,kei-runtime-core,kei-atom-discovery,kei-agent-runtime,kei-capability,kei-provision,kei-entity-store,kei-pipe,kei-cache,kei-spawn,kei-replay name:atom-substrate]) (push) Blocked by required conditions
Makes KeiSeiKit truly multi-LLM: any agent can declare its preferred backend
in its manifest. The DNA resolver picks the right CLI; `kei primary` swaps the
fleet-wide default. KeiSeiKit is no longer tied to Claude Code single-model.
Resolution order: --on=<backend> → manifest provider → primary.toml → claude
Files:
_assembler/src/manifest.rs + Option<String> provider field
_assembler/src/assembler.rs emit provider: in frontmatter (when set)
scripts/kei-agent-cli.sh DNA resolver; `kei primary` get/set; `kei agent`
arm (DNA-driven); honest kimi handling (TUI-only)
bin/kei new arms: agent, primary
_primitives/cli-backends.toml mark kimi as tui-only
docs/encyclopedia/multi-cli-agents.md rewritten with DNA flow, smoke
results, rule-enforcement caveat
Smoke 2026-05-26 (real CLI invocations):
claude ✓ via `claude -p`
grok ✓ via `grok --print` (DNA: manifest provider=grok)
agy ✓ via `agy --print` (Antigravity / Gemini)
copilot ✓ via `copilot --prompt` (1 Premium / 9s / 20.6k tok)
kimi ⚠ TUI-only, no print mode; need `kimi acp` JSON-RPC client
codex — register-only (not installed locally)
Rule-enforcement caveat documented: KeiSeiKit hooks fire only inside Claude
Code's PreToolUse pipeline. Non-claude backends carry the agent's PROMPT but
not the hook layer. For tool-level policy on non-claude, route through MCP.
ALSO: fix(stop-hook) — RULE 0.14 session-end-dump.sh "Recombobulating..."
4-minute hang on 18MB+ transcripts. Root cause: kei-memory ingest + frustration-
matrix scan + kei-sleep-sync ran sync at session end. Now async-detached with
per-op portable timeout (timeout/gtimeout/perl alarm). Hook returns in 0.03s.
Raw JSONL saved sync; only index/embedding step deferred (idempotent on
session_id so safe).
155 lines
6.1 KiB
Markdown
155 lines
6.1 KiB
Markdown
# Multi-CLI agent invocation
|
|
|
|
> *Cross-LLM agent execution. Same agent definition, different backend.*
|
|
> *Same DNA, swap the brain. KeiSeiKit is no longer Claude-Code-only.*
|
|
|
|
KeiSeiKit agents are markdown files. Any LLM CLI that takes a prompt can
|
|
host them. Three call shapes:
|
|
|
|
```bash
|
|
kei agent <name> "<task>" # DNA-resolved (manifest → primary → claude)
|
|
kei agent --on=<backend> <name> "<task>" # override DNA
|
|
kei run-via <backend> <name> "<task>" # explicit backend (no DNA lookup)
|
|
```
|
|
|
|
## Backends — smoke-tested 2026-05-26
|
|
|
|
| Backend | CLI | Flag | Smoke | Notes |
|
|
|----------|-----------|--------------|-------|-------|
|
|
| claude | `claude` | `-p` | ✅ | Claude Code, native `--agent` flag |
|
|
| grok | `grok` | `--print` | ✅ | xAI Grok Build TUI, native `--agent` flag |
|
|
| agy | `agy` | `--print` | ✅ | Google Antigravity (Gemini models). Alias: `antigravity` |
|
|
| copilot | `copilot` | `--prompt` | ✅ | GitHub Copilot CLI (`@github/copilot`) |
|
|
| kimi | `kimi` | TUI-only | ⚠ | No print mode — launcher saves prompt to tmpfile + opens TUI for paste. `kimi acp` JSON-RPC integration is future work. |
|
|
| codex | `codex` | `-p` | — | OpenAI Codex (register-only; not installed locally) |
|
|
|
|
Run `kei run-via list` to see installed backends, current primary, and agent names.
|
|
|
|
## DNA — agent prefers a provider
|
|
|
|
Add `provider` to the agent manifest:
|
|
|
|
```toml
|
|
# _manifests/my-agent.toml
|
|
name = "my-agent"
|
|
provider = "grok" # preferred backend; optional
|
|
model = "grok-2" # advisory; informs choice but not yet sent through
|
|
```
|
|
|
|
The assembler emits it into frontmatter:
|
|
|
|
```yaml
|
|
---
|
|
name: my-agent
|
|
provider: grok
|
|
---
|
|
```
|
|
|
|
Resolution order (each falls through if previous returns nothing):
|
|
1. `--on=<backend>` flag on the command line
|
|
2. `provider:` field in agent manifest
|
|
3. `~/.claude/config/primary.toml` (set via `kei primary <backend>`)
|
|
4. Default: `claude`
|
|
|
|
## Primary — your default LLM
|
|
|
|
```bash
|
|
kei primary # show current primary (and fallback)
|
|
kei primary grok # set default to Grok
|
|
kei primary claude # back to Claude Code
|
|
```
|
|
|
|
`kei primary` writes `~/.claude/config/primary.toml`. Any agent without
|
|
its own `provider:` field will resolve to this. This is the lever to
|
|
"swap out Claude Code as the primary shell" — set primary to grok, and
|
|
every `kei agent <name>` runs on Grok.
|
|
|
|
## Usage examples
|
|
|
|
```bash
|
|
# DNA mode (manifest's provider, or primary, or claude):
|
|
kei agent critic "review src/auth.rs"
|
|
|
|
# Override DNA — try the same agent on a different model for a second opinion:
|
|
kei agent --on=grok critic "review src/auth.rs"
|
|
kei agent --on=agy critic "review src/auth.rs"
|
|
kei agent --on=copilot critic "review src/auth.rs"
|
|
|
|
# Explicit backend, no DNA lookup (legacy):
|
|
kei run-via grok critic "review src/auth.rs"
|
|
|
|
# Point at an arbitrary agent file:
|
|
kei agent --on=grok --file=/tmp/my-agent.md "do the thing"
|
|
|
|
# Native --agent flag (grok/claude only):
|
|
KEI_NATIVE_AGENT=1 kei agent critic "review src/auth.rs"
|
|
```
|
|
|
|
## How it works
|
|
|
|
1. Resolves backend from DNA (see above).
|
|
2. Reads `~/.claude/agents/<agent-name>.md` (assembler-generated prompt).
|
|
3. Strips YAML frontmatter.
|
|
4. Composes with task: `<agent prompt>\n\n---\n\nTASK FOR THIS RUN:\n<task>`.
|
|
5. Execs the backend's non-interactive CLI with the composed prompt.
|
|
|
|
No agent file is modified. No new tokens are issued — subscription
|
|
authentication is whatever each CLI uses (its own login / config dir).
|
|
|
|
## When to use each
|
|
|
|
This is a tool, not a recommendation. Each backend has different
|
|
strengths; the substrate is agnostic about which you pick. Pick by:
|
|
|
|
- **Familiarity** — the CLI you already use day-to-day.
|
|
- **Subscription cost** — burn the one with cheaper marginal cost first.
|
|
- **Specific feature** — e.g. `grok --agent` for native sub-agent
|
|
switching mid-conversation; `agy --sandbox` for terminal restriction.
|
|
- **Independent second opinion** — same agent, different model, see if
|
|
conclusions diverge.
|
|
|
|
## Rule enforcement caveat (READ THIS)
|
|
|
|
KeiSeiKit hooks (`numeric-claims-guard`, `citation-verify`, `no-github-push`,
|
|
`safety-guard`, `push-to-main`, etc.) are **Claude Code-side**:
|
|
`PreToolUse:Bash` / `:Edit` / `:Write` events that fire inside Claude Code's
|
|
process. They do **not** propagate to grok / agy / copilot / kimi.
|
|
|
|
That means:
|
|
- **Prompt-level rules** (the agent's instructions inside the `.md`) DO
|
|
carry through — the agent reads Constructor Pattern, Evidence Grading,
|
|
No Hallucination, etc. as part of its system prompt on any backend.
|
|
- **Tool-level enforcement** (hard-deny on `git push github.com`,
|
|
citation guard, etc.) only applies on the **claude** backend. Other
|
|
backends' tool surfaces are governed by THEIR own hooks/policies.
|
|
|
|
If you need true rule-enforcement on a non-claude backend, the path is
|
|
the **MCP server** (`_primitives/_rust/kei-mcp/`): registers KeiSeiKit
|
|
primitives as MCP tools that the other CLI invokes. Tool-side policies
|
|
travel with the MCP wrapper, not with the CLI.
|
|
|
|
## Adding a new backend
|
|
|
|
1. Add a `[backend.<name>]` table to `_primitives/cli-backends.toml`.
|
|
2. Add a case arm in `scripts/kei-agent-cli.sh` `backend_bin()` and
|
|
`backend_invoke()` for the new CLI's print-flag.
|
|
3. Add a row to the smoke-test table above (state PASS/FAIL/PARTIAL).
|
|
|
|
## What it is NOT
|
|
|
|
- Not a router — picks no backend for you; you (or DNA) ask, it dispatches.
|
|
- Not a federation — each backend runs independently with its own
|
|
context; there is no cross-backend state.
|
|
- Not a rule-enforcement layer — hooks only fire on the claude backend
|
|
(see caveat above). For non-claude rule enforcement use MCP server.
|
|
- Not a wrapper around the backend's tool surface — what the CLI can
|
|
do (Bash, file edits, MCP, etc.) is determined by that CLI, not
|
|
KeiSeiKit. The substrate only ships the prompt.
|
|
|
|
## Related
|
|
|
|
- `_primitives/_rust/kei-llm-router/` — Beta-posterior router for
|
|
*programmatic* model selection inside Rust code (a different layer).
|
|
- `_primitives/_rust/kei-mcp/` — MCP server that exposes KeiSeiKit
|
|
primitives to ANY MCP-compatible client (Cursor / Continue / Zed /
|
|
Aider / Cline / Windsurf / OpenClaw).
|