@agi-fans/oh-my-dsh 0.9.0 → 0.11.0

package/README.md

@@ -14,7 +14,7 @@ English · [简体中文](https://github.com/agi-fans/oh-my-dsh/blob/main/README
 
 </div>
 
-![oh-my-dsh terminal interface](https://raw.githubusercontent.com/agi-fans/oh-my-dsh/main/docs/resources/screenshot.webp)
+![oh-my-dsh terminal interface](https://raw.githubusercontent.com/agi-fans/oh-my-dsh/main/apps/site/public/screenshot.webp)
 
 ## Quick start
 
@@ -29,26 +29,28 @@ Run `/login` once inside omdsh to validate and save your DeepSeek API key, then
 
 ## Highlights
 
-- **Durable conversations:** resume sessions, rewind to a human turn, retry, compact, and export complete transcripts as Markdown.
+- **Durable conversations:** search, pin, rename, and resume sessions in `/sessions`; rewind, retry, compact, and export complete transcripts as Markdown or standalone HTML.
 - **Four real session controls:** choose a Harness Agent preset (Standard, PTC, Minimal, or Cordis), Workflow (Default or Plan), tool presentation (Native, Code, or Both), and Access (Read only, Workspace write, or Full access).
 - **Rich terminal input:** mention project files and other sessions with `@`, paste clipboard images, reuse persistent prompt history, edit multiline prompts externally, and retrieve queued follow-ups.
 - **Readable tool activity:** follow streaming calls and live subagent progress, press Down on an empty composer then Enter (or use Alt+A directly) to select a child in the keyboard-driven Agent Hub, steer a continuable child from its transcript, inspect distinct Input and Output sections, expand long results, and keep domain-specific presentation owned by tool plugins.
-- **Live operational context:** see Agent, Workflow, Tools, Access, model, reasoning effort, workspace, Git state, context pressure, tokens, TTFT, throughput, cache, timings, turns, and steps without leaving the composer.
+- **Live operational context:** see Agent, Workflow, Tools, Access, model, reasoning effort, workspace, Git state, context pressure, tokens, TTFT, throughput, cache, timings, turns, and steps without leaving the composer; use `/context` for an inline projection-backed breakdown that remains in the transcript.
 - **Responsive by design:** retain settled transcript layout, coalesce scroll updates, emit row-level terminal diffs, and preserve correct display-cell alignment for CJK text and emoji.
 
 ## Learn
 
-- [Tutorials](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/tutorials.md) — complete a first task, add precise context, guide queued work, recover long sessions, customize the environment, and write an installable plugin.
-- [Skills and MCP](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/skills-and-mcp.md) — extend a project with reusable instructions and external tools.
-- [User plugins](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/plugins.md) — install DSH bundles into the omdsh Profile with `omdsh plugin`.
-- [Architecture](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/architecture.md) — understand the plugin boundaries and runtime data flow.
-- [Performance](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/performance.md) — inspect the benchmarks, methodology, and rendering optimizations.
+The full documentation is also published on the [official site](https://omdsh.agi.fans/).
+
+- [Tutorials](https://omdsh.agi.fans/docs/tutorials) — complete a first task, add precise context, guide queued work, recover long sessions, customize the environment, and write an installable plugin.
+- [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp) — extend a project with reusable instructions and external tools.
+- [User plugins](https://omdsh.agi.fans/docs/plugins) — install DSH bundles into the omdsh Profile with `omdsh plugin`.
+- [Architecture](https://omdsh.agi.fans/docs/architecture) — understand the plugin boundaries and runtime data flow.
+- [Performance](https://omdsh.agi.fans/docs/performance) — inspect the benchmarks, methodology, and rendering optimizations.
 
 ## Why oh-my-dsh
 
 DeepSeek Harness provides a capable agent runtime and a strong architectural idea: everything is a plugin. oh-my-dsh brings that runtime into a calm, keyboard-driven terminal experience without creating a second agent core or hiding Harness behind a parallel abstraction.
 
-The TUI remains a presentation and interaction layer. Sessions, tools, permissions, models, Skills, MCP servers, commands, and telemetry come from Harness services and plugins; omdsh composes them into a terminal application and adds the interface behavior needed to use them comfortably.
+The TUI remains a presentation and interaction layer. Sessions, tools, permissions, models, Skills, MCP servers, commands, and telemetry come from Harness services and plugins; omdsh composes them into a terminal application and adds the interface behavior needed to use them comfortably. `/trajectory` opens a keyboard-driven event ledger with Turn/Step grouping, live following, search, folding, timing, token usage, tool payloads, results, and schemas. `/context` reads the same client-visible Harness projections as the status footer and distinguishes provider-anchored occupancy from heuristic prompt composition.
 
 The project follows four principles:
 
@@ -71,21 +73,29 @@ DeepSeek Harness plugins and services
   @agi-fans/oh-my-dsh — boot and plugin composition
 ```
 
-The TUI package is split into a service definition, local terminal Provider, session and interaction adapters, tool-presentation bridge, command contributions, and interactive Runner. This isolates terminal ownership from Harness domain state and exposes plugin seams only where a capability has an independent lifecycle or owner. See the [architecture overview](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/architecture.md) for the current boundaries and data flow.
+The TUI package is split into a service definition, local terminal Provider, session and interaction adapters, tool-presentation bridge, command contributions, and interactive Runner. This isolates terminal ownership from Harness domain state and exposes plugin seams only where a capability has an independent lifecycle or owner. See the [architecture overview](https://omdsh.agi.fans/docs/architecture) for the current boundaries and data flow.
 
 ## Performance
 
-Performance is part of the TUI architecture: durable sessions replay in linear time, Harness Projections avoid repeated history scans, settled transcript blocks retain formatted layout, and the terminal writer emits row-level diffs. On the documented Apple M5 Pro environment, restoring 10,000 conversation turns takes a median 2.15 ms, 10,000 tool calls take 21.21 ms, and cached updates over a 5,000-turn surface average 0.24 ms per frame.
+Performance is part of the TUI architecture: durable sessions replay in linear time, Harness Projections avoid repeated history scans, settled transcript blocks retain formatted layout, and the terminal writer emits row-level diffs. On the documented Apple M5 Pro environment, restoring 10,000 conversation turns takes a median 2.62 ms, 10,000 tool calls take 22.71 ms, and rendering cached frames over a 5,000-turn surface averages 0.35 ms per frame.
 
-See the reproducible [TUI performance report](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/performance.md) or run `pnpm benchmark:tui` locally.
+See the reproducible [TUI performance report](https://omdsh.agi.fans/docs/performance) or run `pnpm benchmark:tui` locally.
 
 ## Configuration
 
 Run `/login` to configure a provider. DeepSeek still opens the official key dashboard, validates the key, and prefers the stored credential over an inherited `DEEPSEEK_API_KEY`. When a mounted provider registers a Harness authorization flow, `/login` lists that flow and its methods and the terminal only renders the notices and prompts the flow asks for. The same command can also activate a catalog API-key provider or add a custom provider with its own id, base URL, protocol, and model ids. `/model` then lists every live route. `/logout` removes an omdsh-managed choice and, for DeepSeek, falls back to the environment when available.
 
-Model settings can also come from `$DSH_HOME/settings.yaml`. Skills and MCP configuration are documented in [Skills and MCP](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/skills-and-mcp.md).
+Model settings can also come from `$DSH_HOME/settings.yaml`. Use `/model favorite` and `/model unfavorite` to maintain a small local cycle list, then use `Ctrl+P`/`Alt+P` to move through it and `Ctrl+T` to change reasoning effort. Skills and MCP configuration are documented in [Skills and MCP](https://omdsh.agi.fans/docs/skills-and-mcp).
+
+After an upgrade, omdsh can show release notes once at startup. Use `/changelog` for recent entries or `/changelog full` for the complete packaged history. A cached daily npm check reports newer versions without installing anything automatically; both behaviors can be customized in `/settings`. Terminal notifications for completed long turns and human prompts are also configured there and remain off by default.
+
+Generate shell integration without starting the TUI or making network requests:
 
-After an upgrade, omdsh can show release notes once at startup. Use `/changelog` for recent entries or `/changelog full` for the complete packaged history. A cached daily npm check reports newer versions without installing anything automatically; both behaviors can be customized in `/settings`.
+```sh
+omdsh completions bash
+omdsh completions zsh
+omdsh completions fish
+```
 
 ## Development
 

package/config/cordis.yml

@@ -287,6 +287,9 @@
   - id: tui-command-export
     name: '@agi-fans/dsh-tui/command-export'
 
+  - id: tui-command-trajectory
+    name: '@agi-fans/dsh-tui/command-trajectory'
+
   - id: tui-command-integrations
     name: '@agi-fans/dsh-tui/command-integrations'
 

package/lib/args.d.ts

@@ -3,6 +3,39 @@
  * overrides, durable --resume, --dump-config, `omdsh plugin`, and help/version.
  * @module @agi-fans/oh-my-dsh
  */
+export type CompletionShell = 'bash' | 'zsh' | 'fish';
+export declare const OMDSH_CLI_COMMANDS: readonly [{
+    readonly name: "plugin";
+    readonly description: "Manage profile plugins";
+}, {
+    readonly name: "completions";
+    readonly description: "Generate shell completion scripts";
+}];
+export declare const OMDSH_CLI_OPTIONS: readonly [{
+    readonly names: readonly ["--model"];
+    readonly description: "Model route";
+    readonly takesValue: true;
+}, {
+    readonly names: readonly ["--provider"];
+    readonly description: "Provider route";
+    readonly takesValue: true;
+}, {
+    readonly names: readonly ["-r", "--resume"];
+    readonly description: "Resume a durable session";
+    readonly takesValue: true;
+}, {
+    readonly names: readonly ["--dump-config"];
+    readonly description: "Print the composed plugin tree";
+    readonly takesValue: false;
+}, {
+    readonly names: readonly ["-h", "--help"];
+    readonly description: "Show help";
+    readonly takesValue: false;
+}, {
+    readonly names: readonly ["--version"];
+    readonly description: "Show version";
+    readonly takesValue: false;
+}];
 export interface OmdshInvocation {
     /** Positional prompt words, joined by spaces (empty when interactive only). */
     prompt: string[];
@@ -18,6 +51,8 @@ export interface OmdshInvocation {
     plugin: boolean;
     /** pnpm arguments after `omdsh plugin`. */
     pluginArgs: string[];
+    /** Requested completion script, without booting the application. */
+    completions: CompletionShell | undefined;
     /** --help requested. */
     help: boolean;
 }

package/lib/args.js

@@ -3,6 +3,18 @@
  * overrides, durable --resume, --dump-config, `omdsh plugin`, and help/version.
  * @module @agi-fans/oh-my-dsh
  */
+export const OMDSH_CLI_COMMANDS = [
+    { name: 'plugin', description: 'Manage profile plugins' },
+    { name: 'completions', description: 'Generate shell completion scripts' },
+];
+export const OMDSH_CLI_OPTIONS = [
+    { names: ['--model'], description: 'Model route', takesValue: true },
+    { names: ['--provider'], description: 'Provider route', takesValue: true },
+    { names: ['-r', '--resume'], description: 'Resume a durable session', takesValue: true },
+    { names: ['--dump-config'], description: 'Print the composed plugin tree', takesValue: false },
+    { names: ['-h', '--help'], description: 'Show help', takesValue: false },
+    { names: ['--version'], description: 'Show version', takesValue: false },
+];
 const HELP = `
 omdsh — a TUI coding agent on the DeepSeek Harness runtime
 
@@ -11,6 +23,7 @@ Usage:
   omdsh plugin add <package>
   omdsh plugin remove <package>
   omdsh plugin <pnpm-args...>
+  omdsh completions bash|zsh|fish
 
 Options:
   --model <name>      model route (default deepseek-v4-flash)
@@ -39,9 +52,21 @@ export function parseOmdshArgs(argv, version) {
             dumpConfig: false,
             plugin: true,
             pluginArgs: argv.slice(1).map(String),
+            completions: undefined,
             help: false,
         };
     }
+    if (argv[0] === 'completions') {
+        const shell = argv[1];
+        if (shell !== 'bash' && shell !== 'zsh' && shell !== 'fish')
+            usageError('completions requires bash, zsh, or fish');
+        if (argv.length !== 2)
+            usageError('completions accepts exactly one shell');
+        return {
+            prompt: [], model: undefined, provider: undefined, resume: undefined, dumpConfig: false,
+            plugin: false, pluginArgs: [], completions: shell, help: false,
+        };
+    }
     const prompt = [];
     let model;
     let provider;
@@ -94,7 +119,7 @@ export function parseOmdshArgs(argv, version) {
     if (dumpConfig && (resume !== undefined || prompt.length > 0)) {
         usageError('--dump-config cannot be combined with a prompt or --resume');
     }
-    return { prompt, model, provider, resume, dumpConfig, plugin: false, pluginArgs: [], help };
+    return { prompt, model, provider, resume, dumpConfig, plugin: false, pluginArgs: [], completions: undefined, help };
 }
 function usageError(message) {
     console.error('omdsh: ' + message);

package/lib/bin.js

@@ -20,7 +20,11 @@ if (invocation.model !== undefined)
     process.env.OMDSH_MODEL = invocation.model;
 if (invocation.provider !== undefined)
     process.env.OMDSH_PROVIDER = invocation.provider;
-if (invocation.plugin) {
+if (invocation.completions !== undefined) {
+    const { generateCompletions } = await import("./completions.js");
+    process.stdout.write(generateCompletions(invocation.completions));
+}
+else if (invocation.plugin) {
     const { dumpErrorMessage, prepareLaunchEnvironment } = await import("./composition.js");
     const { runPlugin } = await import("./plugin.js");
     try {

package/lib/completions.d.ts

@@ -0,0 +1,3 @@
+/** Shell completion generation from the canonical omdsh CLI metadata. */
+import { type CompletionShell } from './args.ts';
+export declare function generateCompletions(shell: CompletionShell): string;

package/lib/completions.js

@@ -0,0 +1,52 @@
+/** Shell completion generation from the canonical omdsh CLI metadata. */
+import { OMDSH_CLI_COMMANDS, OMDSH_CLI_OPTIONS } from "./args.js";
+const words = [...OMDSH_CLI_COMMANDS.map(command => command.name), ...OMDSH_CLI_OPTIONS.flatMap(option => option.names)].join(' ');
+function bash() {
+    return `# bash completion for omdsh
+_omdsh() {
+  local cur prev
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  if [[ "$prev" == "completions" ]]; then COMPREPLY=( $(compgen -W "bash zsh fish" -- "$cur") ); return; fi
+  COMPREPLY=( $(compgen -W "${words}" -- "$cur") )
+}
+complete -F _omdsh omdsh
+`;
+}
+function zsh() {
+    const options = OMDSH_CLI_OPTIONS.map(option => `  '${option.names.join(',')}[${option.description}]${option.takesValue ? ':value:' : ''}'`).join(' \\\n');
+    return `#compdef omdsh
+_omdsh() {
+  local -a commands
+  commands=(${OMDSH_CLI_COMMANDS.map(command => `'${command.name}:${command.description}'`).join(' ')})
+  _arguments -s \\
+${options} \\
+  '1:command:->command' '*::argument:->args'
+  case $state in
+    command) _describe 'command' commands ;;
+    args) [[ $words[2] == completions ]] && _values 'shell' bash zsh fish ;;
+  esac
+}
+_omdsh "$@"
+`;
+}
+function fish() {
+    const options = OMDSH_CLI_OPTIONS.flatMap(option => {
+        const long = option.names.find(name => name.startsWith('--'));
+        const short = option.names.find(name => /^-[^-]$/u.test(name));
+        if (long === undefined)
+            return [];
+        return [`complete -c omdsh${short === undefined ? '' : ` -s ${short.slice(1)}`} -l ${long.slice(2)}${option.takesValue ? ' -r' : ''} -d '${option.description.replace(/'/gu, "\\'")}'`];
+    });
+    const commands = OMDSH_CLI_COMMANDS.map(command => `complete -c omdsh -f -n '__fish_use_subcommand' -a '${command.name}' -d '${command.description}'`);
+    return ['# fish completion for omdsh', ...options, ...commands, "complete -c omdsh -f -n '__fish_seen_subcommand_from completions' -a 'bash zsh fish'", ''].join('\n');
+}
+export function generateCompletions(shell) {
+    if (shell === 'bash')
+        return bash();
+    if (shell === 'zsh')
+        return zsh();
+    return fish();
+}
+//# sourceMappingURL=completions.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agi-fans/oh-my-dsh",
   "description": "omdsh: TUI coding agent command over the DeepSeek Harness runtime",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "homepage": "https://github.com/agi-fans/oh-my-dsh#readme",
   "repository": {
     "type": "git",
@@ -90,7 +90,7 @@
     "@deepseek-ai/dsh-settings-file": "0.1.1-rc.2",
     "@deepseek-ai/dsh-credentials-local": "0.1.1-rc.2",
     "@deepseek-ai/dsh-authorization": "0.1.1-rc.2",
-    "@agi-fans/dsh-tui": "^0.9.0"
+    "@agi-fans/dsh-tui": "^0.11.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"