Introduction

When developing agents in DeepSeek Harness (DSH) sessions, tracking becomes difficult if task states are scattered only in the conversation: it is not easy to see at a glance how tasks are broken down, which have dependencies, which are completed, and which still require approval. The philosophy of the DSH ecosystem is “everything is a plugin”; the community directory here is an independent site with no official affiliation with DeepSeek / High-Flyer.

Below is an introduction to octie-dsh-plugin. It is a DSH bundle plugin maintained by StarChen-Cycler, wrapping the octie state-oriented task graph kernel into an installable plugin. As of 2026-09-01, the project is in incremental maintenance.

What is it

One-sentence positioning: A state-oriented task graph kernel for the agent era, refactored into a DeepSeek Harness (DSH) installable bundle plugin.

Its core principle is State is derived, not set: state is read-only derived, not manually set. The task graph organizes around atomic tasks with dependencies between tasks; after completing a task, downstream tasks are automatically unlocked via BFS (Breadth-First Search). Atomic validation is performed when creating tasks to reject vague tasks; immutable snapshots (SHA-256) are used to support long session recovery.

It provides two interfaces:

  • Standalone CLI (octie) and Web UI (octie serve)
  • DSH bundle plugin: 13 octie_* model tools, octie Cordis service, octie/* events, client task panel, pre-configured agent preset

Both interfaces share the same task graph storage:

.octie/project.json

Core Features

State-Oriented Task Graph

State transitions are as follows:

ready → in_progress → in_review → completed

The only manual transition is approve. After completing a task, downstream tasks are automatically unlocked via BFS.

The key here is that state is not manually maintained but derived from task states. Atomic validation is also performed during task creation to help avoid vague tasks entering the task graph.

DSH Plugin Capabilities

After installation, the following can be used in DSH sessions:

  • 13 octie_* model tools
  • octie Cordis service
  • octie/* events

DSH client task panel supports:

  • List view
  • Hierarchical DAG view
  • Project activity sorting
  • Real-time sync
  • Graph physical toggle

The plugin will also automatically pre-configure the “Octie Task Graph Mode” agent preset. If the preset already exists, it will never be overwritten.

Standalone CLI and Web UI

Without relying on DSH, you can also use the standalone CLI:

octie

and the Web UI:

octie serve

The CLI and DSH plugin share the same task graph storage, allowing switching usage between terminals, script pipelines, and DSH sessions.

Installation and Activation

Requires Node.js ≥ 20.

Recommended installation via npm package:

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

Can also be installed from GitHub:

dsh plugin --profile <name> add github:StarChen-Cycler/octie-dsh-plugin

Note: When installing from GitHub, the web interface resources for octie serve are not included; to use the Web UI, you need to build it yourself.

After installation, DSH needs to be restarted; Node-side changes take effect only after a restart.

After the above steps, you can check the plugin mounting status:

dsh --profile <name> --dump-config | grep -i octie

Typical Usage

Standalone CLI Usage

First, install the CLI globally:

npm install -g octie-cli

Initialize the project:

octie init

Create a task. The example below provides title, description, success criteria, and deliverables:

octie create --title "Implement login endpoint" --description "POST /api/auth/login：校验凭据、签发 JWT。" --success-criterion "Returns 200 with JWT for valid credentials" --deliverable "src/api/auth/login.ts"

View the task list:

octie list --format md

Maintain task progress:

octie update <id> --complete-criterion <cid>

Approve a task. This step triggers the unlocking of downstream tasks:

octie approve <id>

Start the web interface:

octie serve

DSH Session Usage

After installing and restarting in DSH, the plugin provides 13 octie_* model tools, octie Cordis service, and octie/* events for planning, executing, and tracking the task graph within the session.

The “Octie Task Graph Mode” agent preset, automatically pre-configured with the plugin, can be directly used for task graph work mode.

Updates and Known Notes

Update order is first global CLI, then DSH plugin:

npm update -g octie-cli
dsh plugin --profile <name> update octie-cli

After updating, you can check the mounting status:

dsh --profile <name> --dump-config | grep -i octie

Particular attention is required:

  • If the global octie-cli stays at a version earlier than 1.2.0, it may cause DSH to install the plugin as a regular dependency. If you encounter such issues, first update the global CLI, then update the DSH plugin.
  • When installing from GitHub, update needs to use the same source:
dsh plugin --profile <name> update github:StarChen-Cycler/octie-dsh-plugin

Otherwise, both installation paths will coexist.

  • After DSH installation, DSH needs to be restarted; Node-side changes take effect only after a restart.

Use Cases and Considerations

Suitable for the following scenarios:

  • Want to plan, execute, and track the task graph directly in DSH agent sessions
  • Want tasks to have clear success criteria, deliverables, and approval gates
  • Want CLI, Web UI, and DSH sessions to share the same task graph
  • Long sessions need to recover task states based on snapshots

Pre-use considerations:

  • Requires Node.js ≥ 20
  • The plugin runs with the current dsh process permissions; you should check the source code and license before installing; this plugin’s license is MIT (inherited from upstream)
  • The DSH community directory is not an official app store; it has no official affiliation with DeepSeek / High-Flyer
  • When installing from GitHub, the web interface resources for octie serve are not included
  • Pre-configured agent presets will not be overwritten if they already exist

Links

  • Directory page: https://www.skillhub.cn/plugins/StarChen-Cycler/octie-dsh-plugin
  • GitHub: https://github.com/StarChen-Cycler/octie-dsh-plugin