@cjhyy/code-shell-capability-coding

@cjhyy/code-shell-capability-coding

Optional coding capability pack for @cjhyy/code-shell-core. It owns CodeShell's coding policy and implementations: the terminal-coding preset, coding prompt, Git/worktree behavior, LSP, ApplyPatch, NotebookEdit, review/quota helpers, and external coding-agent adapters.

The package is deliberately separate from core. A service building a customer support, data, or media agent can install core without pulling a coding preset into its default runtime. The TUI and Desktop applications install this pack at their composition roots.

Use with core

import { Engine } from "@cjhyy/code-shell-core";
import { CODING_CAPABILITY } from "@cjhyy/code-shell-capability-coding/capability";

const engine = new Engine({
  llm: {
    provider: "anthropic",
    model: "claude-sonnet-4-6",
    apiKey: process.env.ANTHROPIC_API_KEY!,
  },
  capabilities: [CODING_CAPABILITY],
});

// No preset is required: this capability contributes terminal-coding as its
// product default. Passing preset: "general" remains supported.
const result = await engine.run("Inspect this repository and fix the failing test.");
console.log(result.text);

For a process composition root, registerCapability(CODING_CAPABILITY) installs the same pack for subsequently created Engines and RunManagers. Prefer the per-Engine capabilities field in reusable libraries and tests.

Focused entry points

The package root remains compatible with existing consumers. New hosts should prefer the smallest stable entry that matches their responsibility:

Entry	Responsibility
/capability	CODING_CAPABILITY, contributed tools, and coding presets
/git	Git, worktree, project-root, and review-prompt helpers
/orchestration	Claude Code/Codex discovery, transcripts, drivers, quota, and external-agent config

import { createWorktree, resolveProjectRoot } from "@cjhyy/code-shell-capability-coding/git";
import { probeClaudeCli } from "@cjhyy/code-shell-capability-coding/orchestration";

These are subpaths of the same npm package, not independently versioned packages. LSP, ApplyPatch, NotebookEdit, and other compatibility exports remain available from the root. The legacy briefTool formatter is also retained as a root compatibility export, but it is no longer registered with the default coding preset: user-facing Markdown should be returned as normal assistant text.

Boundary

• Core owns lifecycle contracts and calls generic capability hooks.
• This package owns repository context, instruction boundary detection, worktree-specific tool services, and coding artifact detectors.
• Desktop owns the Electron host, renderer panels, protocol bridge, and app packaging. The Desktop worker uses this package's agent-server wrapper.

License

MIT. ApplyPatch carries its upstream Apache-2.0 notice in src/tools/apply-patch/NOTICE.md and LICENSE-codex.