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
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
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
- ACP subagent provider β process lifecycle, stop-reason mapping, permission policy, and safe diagnostics.
- Delegation tool β the model-facing
subagent_cell_clischema and results. - Subagent subsystem β the service contract and terminal result semantics.
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-cliexecutable 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
rejectpolicy denies every child permission request;allowapproves 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 dshsource 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.