dsh-irmia-devkit
Curated Irmia DevKit tools for DeepSeek Harness (DSH). Nine battle-tested tools ported as-is from Irmia DevKit v2.6.4, covering the gaps the Harness runtime does not ship natively.
Features
| Group | Tools | What they do |
|---|
| Safe editing | safe_edit · safe_rollback · multi_edit | Backup → edit → syntax gate → auto-rollback on failure. safe_rollback(list=true) lists backups; multi_edit does atomic cross-file batch edits |
| Networking | http_get · http_post | SSRF-guarded HTTP (private-network blocking + per-hop redirect re-check) |
| Code understanding | code_index · code_explore · code_diff_impact | Symbol indexing (AST + SQLite + FTS5) with BFS call-graph queries; code_index(status=true) checks index health |
| Read-only DB | db_query | SELECT/PRAGMA whitelist + engine-level mode=ro read-only |
Zero third-party Python dependencies — pure standard library (chardet / tree-sitter are optional enhancements with graceful fallback).
Install
Requires Node.js ≥ 18 and python3 (≥ 3.9) on PATH. This package ships as a DSH bundle (dsh.bundle), installed into a profile via dsh plugin:
# From npm (recommended)
npx @deepseek-ai/dsh plugin --profile web add dsh-irmia-devkit
# From GitHub (pin a version)
npx @deepseek-ai/dsh plugin --profile web add github:irmia2026/dsh-irmia-devkit#v0.1.0
Verify the layer landed before launching:
npx @deepseek-ai/dsh --profile web --dump-config # look for a "# == dsh-irmia-devkit" layer
npx @deepseek-ai/dsh web
Configuration
| Field | Default | Description |
|---|
pythonPath | python3 | Executable used to run the bundled Python tools |
How it works
Model → Cordis tool (index.js / src/tools.js)
│ execFile("python3", python/runner.py <tool> '<json-args>')
▼
python/runner.py → python/tools/*.py (DevKit modules, unchanged)
▼
JSON result back to the model
- The JS layer only defines tool schemas and bridges to subprocesses.
- The Python core comes from irmia_devkit_open v2.6.4, unmodified.
- Per-tool behavior (arguments, guards, return protocol) is preserved exactly.
Development
node test/smoke.mjs # requires node_modules with @deepseek-ai/dsh-tools
Repo-internal design docs: docs/COMPARISON.md (DevKit ↔ Harness tool comparison) and docs/PORTING.md (port blueprint).
License
AGPL-3.0. Python tool core © 2026 伊尔弥亚 / irmia2026, from Irmia DevKit, AGPL-3.0. This repository is a derivative work distributed under AGPL-3.0.
