Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@serjm/deepseek-code) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DeepSeek Code

Open-source AI coding agent for developers who want a fast terminal workflow without Copilot pricing.

English · Русский

The Short Version

DeepSeek Code is a terminal-first AI coding agent. It reads your project, edits files, runs commands, reviews code, remembers context, and can automate Chrome when a task needs a browser.

It is built for developers who want a practical local workflow:

Lower cost: use DeepSeek API directly instead of a fixed monthly coding subscription.
Real project work: inspect files, patch code, run tests, and continue from previous sessions.
Terminal-native: no IDE lock-in, no heavy desktop app, no cloud workspace requirement.
User-controlled automation: choose read-only planning, manual approvals, auto-edit, or full turbo mode.

Install

npm install -g @serjm/deepseek-code

Run it:

deepseek-code

Or run without installing:

npx @serjm/deepseek-code

Short alias:

dsc
dsc -p "Find the bug in auth.ts and patch it"
dsc --headless --json -p "Review this repository"

Why Use It

Need	DeepSeek Code
Fix code from the terminal	Reads files, proposes patches, and runs verification commands
Keep costs predictable	Uses your DeepSeek API key directly
Work inside existing repos	Runs where your code already lives
Avoid blind automation	Approval modes keep edits and shell commands under your control
Debug browser flows	Built-in Chrome automation for pages, forms, console, screenshots, and network state
Keep context over time	Project memory and resumable sessions help with longer work

What It Can Do

You: "Find why checkout fails after login and fix it"

DeepSeek Code:
  1. Searches the relevant files
  2. Reads the auth and checkout code
  3. Applies a focused patch
  4. Runs tests or the command you approve
  5. Summarizes the change

Core features:

Autonomous coding agent: plans, reads, edits, searches, and runs commands.
Full terminal UI: streaming output, tool activity, status, costs, and context usage.
Approval modes: Plan, Default, Auto-Edit, and Turbo.
Browser automation: open pages, click, fill forms, inspect console/network, take screenshots.
MCP support: connect external tool servers for custom workflows.
Persistent memory: save project facts with /remember.
AI code review: use /review to inspect bugs, risks, and security issues.
Headless mode: CI-friendly JSON output with --headless --json.

Commands

Command	Description
`/help`	Show available commands
`/setup`	Configure API key, language, and approval mode
`/remember <text>`	Save project context
`/memory`	Show saved memories
`/review`	Run AI code review
`/checkpoint`	Save a git checkpoint
`/restore`	Restore a checkpoint
`/theme`	Switch terminal theme
`/lang`	Switch language
`/git <cmd>`	Run git operations
`/loop <interval> <task>`	Schedule recurring work
`/sandbox`	Run commands in Docker isolation
`/mcp`	Manage MCP servers
`/stats`	Show session statistics
`/clear`	Clear chat

Configuration

Use environment variables:

export DEEPSEEK_API_KEY="sk-..."
export DEEPSEEK_MODEL="deepseek-chat"

Or create .deepseek-code/settings.json in your project:

{
  "apiKey": "sk-...",
  "model": "deepseek-chat",
  "approvalMode": "default",
  "temperature": 0.7
}

Safety Model

DeepSeek Code is designed around explicit control:

Plan: read-only analysis.
Default: asks before edits and commands.
Auto-Edit: file edits are automatic, shell commands still need approval.
Turbo: full automation for trusted local work.

It also supports command sanitization, file size limits, .deepseekignore, checkpoints, and optional Docker sandboxing.

Development

git clone https://github.com/SerjMihashin/deepseek-code.git
cd deepseek-code
npm install
npm run build
npm test

Package check:

npm pack --dry-run
npm publish --dry-run --access public

Publish to npm:

npm login
npm publish --access public

If npm asks for two-factor authentication:

npm publish --access public --otp=123456

@serjm/deepseek-code