Skip to content

ch-subagent-cell-cli

Verified

@machina.ai/ch-subagent-cell-cli Β· v0.2.1-rc2.c4 Β· MIT

One-shot Cell CLI subagent bundle over the Agent Client Protocol

Install

dsh plugin add @machina.ai/ch-subagent-cell-cli

Confirm the layer applied with dsh --profile default --dump-config β€” see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Creators

Readme


description: "The one-shot Cell CLI subagent bundle for Cell Harness users enabling Cell CLI delegation and maintainers configuring its ACP child." kind: "package-bundle"

@machina.ai/ch-subagent-cell-cli

English | δΈ­ζ–‡

Summary

Enable this Bundle when delegated work should run in a genuine, unattended Cell CLI session in the parent Session's workspace. Each delegation starts a fresh cell-cli --acp process for one self-contained text task and returns only the final answer or a safe failure diagnostic. Cell CLI keeps its own authentication, model, and settings. The Bundle contains no provider code: it composes the generic ACP subagent provider with the delegation tool and adds subagent_cell_cli to every Agent as a global tool. In Cell Harness it takes the Plugins-page slot that upstream DeepSeek Harness gives to the Codex subagent.

Table of Contents


Use this package

Install Cell CLI so that cell-cli is on the Host's PATH, sign in once with cell-cli interactively, then enable Cell-cli subagent under Experimental plugins on the Web or Desktop Plugins page. The layer registers the cell-cli provider and the global subagent_cell_cli tool; it starts no process until the first delegation. Switching it off removes the tool from the running Host, so live Agents see the change on their next request.

Configuration

The layer inserts two Host rows. A later profile patch can restate either row's config by id; a patch replaces the whole config, so restate every field.

Row id Package Shipped config
subagent-cell-cli @deepseek-ai/dsh-subagent-acp providerName: cell-cli, command: cell-cli, args: ['--acp'], permission: reject
tool-subagent-cell-cli @deepseek-ai/dsh-tool-subagent provider: cell-cli, toolName: subagent_cell_cli, maxDepth: provider-managed

permission: reject denies every session/request_permission the child sends, so Cell CLI tools that require approval, such as file edits and shell commands, do not run. Restate the provider row with permission: allow to approve them unattended. Credential-shaped ambient variables are removed from the child environment; supply any variable Cell CLI needs through the provider row's env. The ACP provider README documents every accepted field.

- id: subagent-cell-cli
  config:
    providerName: cell-cli
    command: cell-cli
    args: ['--acp']
    permission: allow

Understand the implementation

Implementation details β€” click to expand

cordis.patch.yml is the whole runtime: src/index.ts exports nothing. The Plugins page lists the Bundle because ON_DEMAND_BUNDLES names it and the generated Official catalog embeds its locale/*.json text (English, Chinese, and Spanish (Mexico)) and icon.svg. The @machina.ai/cell-harness installation depends on the package, so its Plugins page offers it as installation-provided; other installations offer the ordinary on-demand install target. The Agent Note records why the catalog lists change while the Codex package stays untouched.


Further Exploration


Model Experience

Child request

What the model sees

The Cell CLI child receives the standalone task text over ACP in a fresh session whose workspace is the selected child working directory. Its system prompt, tools, and model come from Cell CLI's own configuration; it receives no parent conversation.

Token effect

The child pays for an independent Cell CLI context and turn. Child tokens do not enter the parent's context.

KV Cache effect

Independent of the parent request cache. Reuse depends only on Cell CLI's own model, instructions, and tools.

Parent scheduling and results, indirectly

What the model sees

Through dsh-tool-subagent, the parent model first receives a child id, then the child's final streamed answer or a failure notice with its stop reason and the ACP provider's safe diagnostic, including the fixed permission-decision line when the child asked for approval.

Token effect

Parent input grows by the start acknowledgement and completion notice. Enabling the Bundle adds the subagent_cell_cli schema to every Agent's tool list.

KV Cache effect

Start acknowledgements and completion notices append after the reusable parent request prefix. Toggling the Bundle changes the tool list of live Sessions, which invalidates their cached request prefix once.

Known Limitations and Deferred Work

  • Cell CLI must be installed and signed in on the Host β€” the Bundle does not ship Cell CLI or authenticate it; a missing cell-cli executable fails the first delegation at process startup.
  • One fresh process and session per run β€” there is no continuation, resume, pooling, or progress stream.
  • No human approval path β€” the shipped reject policy denies every child permission request; allow approves them all without per-call review.
  • No optional shared capabilities β€” agentPreset, agentOptions, output schemas, and harness depth enforcement are rejected by the shared service for the ACP provider.
  • Source-checkout installs are not offered β€” a pnpm dsh source launch anchors on @deepseek-ai/dsh, whose release version differs from this package's Cell Harness version, so its Plugins page reports the install target as unavailable.

Dev Note

Maintainer context β€” click to expand

None.