deepchat-cli

Invoke DeepChat's CLI control plane for model inference, media generation, and configuration management.

6.3k|728|Updated Feb 14, 2025
One-click install
npx skills add https://github.com/ThinkInAIXYZ/deepchat --skill deepchat-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepchat-cli
Source: https://github.com/ThinkInAIXYZ/deepchat/tree/main/resources/skills/deepchat-cli
Command: npx skills add https://github.com/ThinkInAIXYZ/deepchat --skill deepchat-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents often need to call DeepChat capabilities—model inference, image/video/speech generation, transcription, OCR, and configuration queries—that are not exposed as dedicated tools. This Skill provides a governed command-line control plane so an agent can perform those operations through the running DeepChat main process without touching credentials or internal state directly.

Core Features & Use Cases

  • Model Discovery and Invocation: List providers and models, inspect model configuration, and run raw provider calls with model invoke using streaming JSONL output.
  • Media and Document Operations: Generate images, video, and speech, transcribe audio artifacts, and run local OCR extraction with results returned as artifact metadata.
  • Configuration and Management: Read settings, Skills, and MCP server lists, and request renderer-approved changes such as preference settings, HTTPS Skill installs, and new remote MCP configurations.
  • Use Case: A user asks the agent to compare two models on a prompt. The agent lists providers and models, invokes each model with the same prompt via deepchat model invoke --jsonl, and reports the structured results without mutating any global defaults.

Quick Start

Ask the agent to check DeepChat's runtime status and list enabled providers, then invoke a chosen model with your prompt using the deepchat CLI.

Frequently Asked Questions about deepchat-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I invoke a DeepChat model from the command line?

Run deepchat model invoke with the provider ID, model ID, and a quoted prompt, adding --jsonl for streaming output. Discover valid IDs first with deepchat provider list and deepchat model list rather than guessing them.

How do I generate images or video through DeepChat CLI?

Use deepchat image generate or deepchat video generate with a provider ID, model ID, and quoted prompt in JSONL mode. Generated media stays in DeepChat's artifact spool, and the command returns artifact metadata for the application to render.

Can the DeepChat CLI access credentials or upload local files?

No. Agent callers cannot inspect authentication environment variables, use --file or --out flags, or download artifact bytes. Authorization is injected by the main process only after the command passes the normal shell permission check.

Does DeepChat CLI support OCR on documents?

Yes, deepchat ocr extract runs local OCR on an artifact by ID and returns text inline without requiring a provider. Use deepchat ocr status to check runtime state before extraction.

What operations require the DeepChat UI instead of the CLI?

Provider and model configuration, credential writes, local Skill archives, Skill enable/disable/removal, MCP updates and removal, and all destructive operations require the DeepChat UI or a human terminal. Agent callers can only request renderer approval for preference settings, HTTPS Skill installs, and new disabled remote MCP entries.

Why can't an agent run deepchat agent run or run watch?

An agent cannot recursively create a detached agent run, and waiting on its own executing run would deadlock it. Use run get for a nonblocking snapshot or run cancel to request cancellation instead.