Quick start

Launch inside a project

cd /path/to/your-repo
deepseek

DeepSeek TUI assumes you work in context: it reads your tree, runs tools, and proposes edits. Pick a repo you can afford to experiment in.

Start with DeepSeek V4-Flash

V4-Flash is the usual default for exploration: strong tooling support with lower cost than V4-Pro. Escalate to Pro only when a task truly needs heavier reasoning—see pricing for numbers.

Begin in Plan mode

Plan mode keeps everything read-only—perfect for learning how the agent navigates your codebase without touching files or shells.

deepseek --mode plan

Copy-ready first prompt:

Summarize this repository: main folders, entry points, dependencies,
and the safest place to start improvements. Stay read-only.

Move to Agent mode for edits

When you trust the plan, switch to Agent mode so the assistant can propose patches and commands with approvals.

About YOLO mode

Good beginner tasks

• Map unfamiliar modules before editing.
• List redundant utilities or duplicated helpers.
• Add documentation for one package at a time.
• Generate a checklist of tests to run after a change.

Useful commands

/compact
/session save my-notes
/mode plan
/mode agent
/mode yolo
/exit

Stay mindful of tokens

Large reads, wide searches, and long chats add up. Structure prompts, compact sessions when they sprawl, and default to Flash unless Pro is clearly warranted.

Walkthrough video

Same lazy-load player as the homepage—click when you want audio and motion.