[ any cli ][ one server ]
CLI Delegation

Plot every CLI on one sheet.

Any CLI becomes a delegate. Delegates become a council. The council ships one verdict.

$npx -y clinkx@latest
Fig.01 · Convergence
⊢ many agentsone verdict ⊣
Context Receipt
{
  "run_id": "ctx_0617",
  "status": "ok",
  "recommended_clink": {
    "absolute_file_paths":
      ["src/server.ts"]
  }
}
clink · context_builder · councils · elaris
§Abstractfive chapters · one sheet

Alone, each CLI is an opinion. Convened, they’re a verdict.

ITools & pipeline

One surface. Every tool.

§ 1.0 · index
Delegationclink · clink_agent_run · clink_agent_manage§ 1.1
Contextcontext_builder · refine_context_run§ 1.2
Councilsrun_workflow · resume_workflow · list_workflows · workflow_run_status · cancel_workflow[ ch. II ]
Sessionsclink_elaris_run · clink_elaris_manage[ ch. V ]
§ 1.1

clink

Run a configured CLI as a subprocess subagent and return its final output. Single-shot, stateless, safe to run in parallel.

grokcodexclaudeglm…anything
§ 1.2

context_builder

Build a persisted, attachable context bundle from allowed roots before you delegate. Deterministic selection; any prior run can be refined.

manifest.jsonartifacts/bundle.mdminified receipt
§ 1.3

context pipeline

anchor

name the focus

select

same inputs, same picks

bundle

one durable folder

receipt

one small JSON

delegate

paths → clink

IICouncils

Many models deliberate. One verdict ships.

Memberspropose in parallel
codexglmclaudegrok
Reviewersevaluate anonymously
reviewer · areviewer · breviewer · c
Rankingdeterministic reducer
rank + score
Chairmansynthesizes the verdict
final decision
Shipped councils
council-defaultPropose, review, decide.
council-answerOne deliberated answer.
council-code-reviewReviewers assess; chairman rules.
council-debugCompeting hypotheses, one verdict.
council-discoverSurvey an unfamiliar codebase.
council-plan-reviewAdvisory synthesis; never approval.
Control plane

Start a council, step away, come back — every run is resumable and can be checked on at any time.

run_workflowresume_workflowlist_workflowsworkflow_run_statuscancel_workflow
III · aRun monitor

Watch the verdict land.

a council run, replayed from the workflow dashboard

Animated demo replaying a council-code-review run: context preflight succeeds (discover, curator, finalizer, materialize), three reviewers run in parallel, cross-review and ranking follow, and the chairman lands the verdict — approve, two advisory notes, synthesis at artifacts/verdict.md.

III · bProgress board

Agents write. The board reads.

a session's shared progress page, replayed live

Animated demo replaying an agent progress report for the run-monitor parity restyle session: twelve tasks on a completion timeline, four agents, and a live activity log. Tasks flip to done as agents write, completion climbs from 58 to 75 percent, and the reviewer picks up the parity reshoot.

IVConfig & safety

Adapters, not allowlists.

Any CLI you can spawn, described in one JSON file.

discovery order: CLINKX_CONFIG_PATH, then XDG config, then bundled conf/adapters — first location with adapters wins. Node >= 24. Animated demo probes each location and loads grok.json from conf/adapters.

conf/adapters/grok.jsonAdapter
{  "name": "grok",  "command": "grok",  "args": ["--always-approve", "--verbatim", …],  "parser": "claude_stream_json",  "prompt_mode": "file",  "timeout_seconds": 3600}
mcp client configvia npx
{
  "mcpServers": {
    "clinkx": {
      "command": "npx",
      "args": ["-y", "clinkx@latest"],
      "env": {
        "CLINKX_ALLOWED_ROOTS": "/path/to/workspace"
      }
    }
  }
}
4.3 · Safety

Inputs are validated before anything spawns. What spawns runs as you — no sandbox, no pretense.

allowed rootsinput validationsanitized envsecret-aware bundles
VSessions

Elaris sessions, driven from your CLI.

A sister project, exposed as an opt-in remote session family — start long-running remote agents and drive them without leaving the MCP surface.

Animated demo replaying an Elaris session: the run starts on a worktree, reads the README with one secret redacted, proposes a plan, produces a diff, takes a second turn, and pushes — the session stays alive for turn three.

Two toolsclink_elaris_run starts a session; clink_elaris_manage drives it.
Multi-turnkeep_alive sessions take follow-up turns, recoverable by run_id.
GitHub-awareTarget a branch or create a worktree — validated before send.
Credential-safe readsEvery read carries a redaction count; raw blobs withheld on detection.
clink_elaris_runRemote
{
  "prompt": "Update the README",
  "permission_mode": "auto",
  "github_repo": { "full_name": "owner/repo" },
  "keep_alive": true
}
v.1.1.0Get started

Call the council to order.

One command — every CLI you’ve configured takes its seat.

Client config