Blackman99/codsh 预览 preview

Blackman99/codsh

一个适用于终端的Claude Code风格编码代理,基于DeepSeek Harness(dsh)构建

Project Overview项目介绍

codsh is an autonomous terminal coding agent built directly on top of DeepSeek Harness, supporting DeepSeek models and any OpenAI-compatible LLM endpoint. To install codsh, users first need to have Node.js and npm set up on their system, then run npm install -g @deepseek-ai/dsh codsh-cli to install both dsh and the codsh command line tool. After installation, users need to export their DeepSeek API key as an environment variable before running the codsh command to launch the agent interface. It is a zero-dependency launcher that locates your existing local dsh installation and registers a custom profile for codsh.

The flagship /ship command turns a one-sentence feature idea into fully working, verified code through an automated seven-stage engineering pipeline. This pipeline includes pre-flight git checks, goal clarification, automated design interview, spec writing, task decomposition into a dependency DAG, parallel implementation in isolated worktrees, and final verification before merging back. codsh offers multiple ways to view the ongoing task flow, including an in-terminal ASCII DAG visualization, a pinned status row, and an interactive web-based flowchart that updates in real time.

codsh supports most popular terminals at varying compatibility levels, with first-class support for iTerm2, Terminal.app, VS Code, tmux, and Windows Terminal with WSL. Second-class terminals including Ghostty, kitty, Alacritty, and Warp are also fully supported, with any compatibility regressions treated as reportable bugs. Only native Windows PowerShell receives best-effort basic TTY support, and persistent PTY functionality is not available there. codsh is released under the permissive MIT open source license, and welcomes community contributions and bug reports.

Codsh 是基于 DeepSeek Harness 构建的自主终端编码代理,面向 DeepSeek 模型及所有兼容 OpenAI 接口的端点提供编码服务。用户可通过 npm 全局安装 codsh-cli 与 dsh 后,配置 DeepSeek API 密钥即可启动使用。它的核心功能 /ship 命令可将用户一句话需求转化为经过完整验证的代码,整个过程遵循七步自动化工程流程,还支持在终端和浏览器展示实时任务流全景。

这款工具适合需要快速将创意转化为可运行代码的开发者,整体使用流程十分简洁流畅。用户只需输入一句自然语言需求描述,即可启动完整的自动化工作流:从创建隔离分支、梳理目标约束、分解任务依赖,到并行开发验证,最后自动合并回原分支,全程仅需一轮交互。你可以访问项目官方画廊查看各类从单句需求生成的实际项目示例。

Codsh 遵循 MIT 许可开源,对终端的支持分为三个等级,iTerm2、VS Code 终端、Windows Terminal 等属于第一等级,提供发布级阻塞兼容。使用前需要先安装 Node.js 环境与 npm 包管理器,同时需要配置有效的 DeepSeek 或兼容 OpenAI 接口的 API 密钥才能运行。对原生 Windows 终端仅提供基础支持,无法使用持久化 PTY 功能。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile code add codsh-bundle

把 Blackman99/codsh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

codsh — a terminal coding agent for DeepSeek

Site · Gallery · npm · English | 中文

npm version MIT license dsh-plugin topic dshfind Awesome

npm: codsh-cli · command: codsh

codsh is an autonomous terminal coding agent for DeepSeek — and any OpenAI-compatible endpoint — built directly on the DeepSeek Harness (dsh). Not a fork.

Its flagship feature, /ship, turns a one-sentence idea into fully verified code through an autonomous 7-stage engineering pipeline, with a built-in live task flow panorama across terminal and browser.

Want to see what it builds? Visit the gallery for real projects, screenshots, and playable results. Every project was built from a one-sentence request, with just one round of interaction and the recommended answer selected for every question.

Install

npm install -g @deepseek-ai/dsh codsh-cli
export DEEPSEEK_API_KEY="your-api-key"
codsh

Common flags:

  • codsh -p "task" — Run a non-interactive task directly
  • codsh --continue — Continue the last session
  • codsh --resume <id> — Resume a specific session
  • codsh update — Update launcher and profile runtime

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-model-capability 下一个 Next telegram →