Shark Code

Local First, open-source AI coding agent.
A small CLI inspired by Claude Code / OpenCode, with DeepSeek as the default provider.

Install

npm install -g sharkcode

Launch interactive mode:

sharkcode

Or single-shot mode:

sharkcode "explain this codebase"
sharkcode "fix the null pointer bug in auth.ts"

Providers

Shark Code supports multiple providers. Switch between them anytime with /provider.

Provider	Description	Docs
deepseek	DeepSeek 官网 (default)	platform.deepseek.com
ark	火山引擎 方舟 Coding Plan	volcengine.com/activity/codingplan

Configure

Option 1: Slash commands (recommended)

Start sharkcode, then:

◆ /provider ark              # switch to 方舟 Coding Plan
◆ /key sk-xxxxxxxxxx         # set API key (saved automatically)
◆ /model ark-code-latest      # optionally change model

Option 2: Config file

~/.sharkcode/config.toml

[default]
provider = "deepseek"   # or "ark"

[providers.deepseek]
# API key from https://platform.deepseek.com
key = "sk-xxxxxx"
model = "deepseek-chat"

[providers.ark]
# API key from https://ark.cn-beijing.volces.com (方舟 Coding Plan)
key = "sk-xxxxxx"
model = "ark-code-latest"

Option 3: Environment variables

$env:DEEPSEEK_API_KEY="sk-xxxxxx"   # deepseek provider
$env:ARK_API_KEY="sk-xxxxxx"         # ark provider

Slash Commands

Type / commands anytime inside the interactive REPL:

Command	Description
/provider	show current provider & key status
/provider <name>	switch provider (deepseek | ark)
/key <api-key>	set API key for current provider
/model <model-id>	set model for current provider
/clear	clear conversation history
/help	show command list
/exit	quit

Run from source

git clone https://github.com/syy-shark/sharkcode.git
cd sharkcode
bun install
bun run start

Upgrade

npm update -g sharkcode

How It Works

User input → Prompt + Tools → LLM → Tool execution → Result → Repeat

Built-in tools:

Tool	Description
read_file	Read a file
write_file	Create or overwrite a file
edit_file	Replace an exact string in a file
bash	Execute a shell command with approval

Tech Stack

• Bun + TypeScript
• Vercel AI SDK
• DeepSeek API / 火山引擎 方舟 API

License

MIT