octie-dsh-plugin DSH plugin

Octie is a persistent task graph state machine designed for the agent era. It provides 13 octie_* model tools, a client task panel, and a pre-installed agent preset for DeepSeek Harness (DSH). Tasks are represented as nodes with blocker dependencies, and state is derived readonly (ready → in_progress → in_review → completed), with BFS auto-unlock and SHA-256 immutability for long-session recovery.

skills-workflows ui-productivity

How to install the octie-dsh-plugin DSH plugin

dsh plugin --profile <name> add octie-cli

This source command needs manual review. Copying does not run it.

octie-dsh-plugin DSH plugin data source

octie-dsh-plugin DSH plugin snapshot date: Aug 16, 2026

discovered

What the octie-dsh-plugin DSH plugin can do

13 octie_* model tools for DSH agent sessions to plan, execute, and track task graphs
Client task panel with list + DAG graph view, project activity sorting, real-time sync, and physics toggle
Pre-installed 'Octie task graph mode' agent preset with persona and workflow guidance
octie usage skill skill for full manual (mental model, invariants, pattern library, pitfalls)
Immutable snapshots (SHA-256) ensuring recoverable long sessions

Where the octie-dsh-plugin DSH plugin fits

Plan and decompose complex tasks into a dependency graph within DSH agent conversations
Track task progress (ready → in_progress → in_review → completed) and approve completions
Automatically unlock downstream tasks via BFS after approval, enabling sequential execution
Real-time sync between DSH tools, CLI, Web UI, and task panel for collaborative editing

Who the octie-dsh-plugin DSH plugin is for

DSH users who need structured task dependency management for agent workflows
Developers building agent frameworks that require a persistent, recoverable task layer

octie-dsh-plugin DSH plugin limitations

Requires Node.js ≥ 20 and DSH environment (DSH client must be installed)
Project under incremental maintenance; features evolve iteratively ('usable first, then iterate')
GitHub source installation does not include Web UI assets; you must build them separately
Dependency on npm package octie-cli; version compatibility with DSH may vary

octie-dsh-plugin DSH plugin: from the repository README

Quoted from the StarChen-Cycler/octie-dsh-plugin README, the upstream source of the octie-dsh-plugin DSH plugin. Copyright remains with the original authors.

> **Status: 项目处于增量维护中（under incremental maintenance）** —— > 新特性、修复与文档会以小幅增量持续合入（例如 DSH 客户端任务面板、项目活跃度排序、 > 外部变更实时同步、图物理开关、随插件预置的 Octie 任务图模式、`octie` 使用技能等）。 > 功能以「先可用、再迭代」的方式演进。 **Octie —— agent 时代的状态导向任务图内核（state-oriented task graph kernel），重构为 DeepSeek Harness（DSH）可安装的 bundle 插件。State is derived, not set：状态只读派生，而非手工设置——the task layer that every agent framework can call。** Octie 是一个面向 agent 时代的**持久化任务图状态机**：节点 = 原子任务，边 = blocker 依赖，状态**只读派生**（`ready → in_progress → in_review → completed`，唯一手动转移是 `approve`），完成一个任务经 **BFS 自动解锁下游**；原子校验在创建时拒绝模糊任务；不可变快照（SHA-256）保证长会话可恢复。 ## 两种使用方式 Octie 同时是**两条并行的一等接口**，共享同一份任务图存储（`.octie/project.json`），可随时互换使用： | 方式 | 形态 | 适合 | |---|---|---| | **独立 CLI / Web UI** | 全局安装 `octie` 命令 + `octie serve` 网页界面 | 终端驱动、脚本管道、不需要 DSH 的场景 | | **DSH bundle 插件** | 13 个 `octie_*` 模型工具 + Cordis 服务 + 任务面板 + 预置 agent preset | 让 DSH agent 直接在会话里规划、执行、追踪任务图 | ## 你能得到什么 - **独立 CLI（`octie`）与 Web UI（`octie serve`）**：不装 DSH 也能用，见下文「CLI 独立使用」 - **13 个 `octie_*` 模型工具** + `octie` Cordis 服务 + `octie/*` 事件——DSH 会话里直接规划、执行、追踪任务图 - **DSH 客户端任务面板**：列表 + 分层 DAG 图视图、项目活跃度排序、实时同步、图物理开关 - **「Octie 任务图模式」agent preset**：随插件自动预置，开箱即用的任务图工作模式 - **`octie` 使用技能**：按需加载的完整用法手册（

Read the full READMERepository license: MIT

octie-dsh-plugin DSH plugin questions

How do I install Octie as a DSH plugin?

Run `dsh plugin --profile <name> add octie-cli` to install the npm package. After installation, restart DSH. The plugin will automatically pre-install the 'Octie task graph mode' agent preset, and the 13 tools and octie skill will be available immediately.

What are the 13 octie_* tools?

The plugin provides 13 model tools for DSH agent sessions, such as creating tasks, updating progress, approving completion, and querying the task graph. For the full list and usage conventions, refer to the `skills/octie/SKILL.md` file in the repository.

Can I use Octie without DSH?

Yes, Octie also offers a standalone CLI (`octie`) and Web UI (`octie serve`). You can install it globally via `npm install -g octie-cli` and use it independently. The task graph storage is shared between the standalone and DSH plugin modes.

How does the task panel real-time sync work?

Changes made via octie_* tools in DSH sessions are pushed to the task panel (list, graph, and dropdown) within seconds. External writes (from terminal CLI, Web UI, or other DSH sessions) are also auto-detected and refresh the panel in real time.

What is the 'Octie task graph mode' agent preset?

It is a pre-installed DSH agent preset that injects Octie's mental model and workflow into the agent. When you create a new session, select 'Octie task graph mode' from the mode selector. The preset requires the agent to read the full octie skill before using any octie_* tool.