Cocode - an open-source DeepSeek Harness distribution that provides both GUI and TUI entry points.
Cocode is an open-source distribution of DeepSeek Harness, providing both a desktop GUI and a terminal TUI. The tool integrates files, Git, terminal, browser, and agent into a single workspace, with sessions synchronized in real-time. Agen...
What is Cocode?
Cocode is an open-source distribution of DeepSeek Harness, providing both a desktop GUI and a terminal TUI. The tool integrates files, Git, the terminal, a browser, and the Agent into a single workspace, with sessions synchronized in real time. Agent capabilities can be freely disassembled and assembled using preset plugins, with critical operations requiring confirmation before execution. Cocode supports the Cocode Nut model service or allows users to provide their own API keys, upgrading AI programming from a chat tool to a trusted and customizable production workbench.
Cocode's main functions
-
Out-of-the-box releaseCocode is an open-source distribution based on DeepSeek Harness, providing both a desktop GUI and a terminal TUI, allowing users to start AI-assisted programming directly without having to configure plugins from scratch.
-
Integrated workspaceIt integrates file browsing, Git version control, terminal command line, built-in browser, and Agent session into a single interface, eliminating the fragmented experience of switching between multiple windows.
-
Dual-end session synchronizationThe GUI desktop client and the TUI terminal client share the same host and session state. Tasks that users are working on on the desktop can be seamlessly continued by entering the terminal via SSH, and no progress will be lost.
-
Detachable Agent PresetThe Agent's capabilities are configured through preset plugins. It has four built-in presets: Standard, PTC, Minimal, and Creator. Users can freely copy and modify the toolsets, prompts, and permission switches.
-
Security confirmation mechanismThe system will automatically pause and display the scope of impact before performing critical operations such as writing files, executing commands, or making network requests. It will only continue execution after user confirmation, ensuring that every step of the operation is safe and controllable.
-
Diff Preview ConfirmationAll code changes support diff preview, allowing users to view the changes line by line before confirming the application, effectively preventing accidental changes or overwriting of existing code.
-
Flexible model integrationIt supports Cocode Nut subscription service, DeepSeek official API Key and any OpenAI-compatible endpoint. You can switch between the three methods at any time and the key will not be written to the session log.
-
Open source cross-platformSupports cross-platform source code building for macOS, Windows, and Linux. The current release includes installers for macOS and Windows.
How to use Cocode
- InstallDownload the GUI installer for your platform from GitHub Releases, or run...
npm install --global @cocode-agency/tuiInstall the terminal client. - start up: Open the GUI application, or run it in a real terminal
cocode doctorExecute after checking the environmentcocodeEnter TUI. - Configuration ModelOn first launch, select Cocode Nut login subscription or enter your own DeepSeek compatible API Key.
- Open workspaceOpen a local code repository in the interface as the working directory, and the Agent will perform operations in this directory.
- Assign taskDescribe your development goals in the conversation, and the agent will automatically analyze the files, invoke tools, and plan the execution steps.
- Confirm operationWhen the Agent needs to modify files, execute commands, or connect to the network, the system will pause and display the scope of the impact. It will only continue after you confirm.
- Review and revisionsView the code diff in the preview panel, and approve the application after confirming that there are no errors. All changes will be written to the workspace.
- Cross-platform sequelWhen you need to switch environments, use the same interface in another entry point (GUI or TUI).
DSH_HOMEWhen the profile is connected to the same host, the task status is automatically synchronized.
Cocode's core advantages
- Ready to use right out of the boxAs a ready-made distribution of DeepSeek Harness, it comes pre-configured with models, tools, skills, and security boundaries, so you can start coding right away after downloading and opening it.
- Seamless switching between two devicesThe desktop GUI and terminal TUI share the same host and session state, allowing tasks initiated on the desktop to be seamlessly continued from the terminal after being SSH'd to the server.
- Integrated workspaceFile browsing, Git, terminal, built-in browser, and Agent conversations all coexist in a single interface, eliminating the need to stitch contexts between multiple windows.
- Agent is transparent and detachableAgent's capabilities are exposed through preset plugins. It has four built-in presets and supports free copying and modification. You can see and adjust its internal structure like opening a computer case.
- Operation is safe and controllableCritical actions such as writing to files, executing commands, and connecting to the network will be paused first, and the scope of the impact will be displayed. They will only continue after your confirmation to avoid accidental operation.
- Changes must be reviewed before releaseAll code changes are presented in diff format in the preview panel. Apply them only after confirming that they are correct, and make sure you are aware of every change.
Cocode's project address
- Project official website:https://cocode.agency/
- GitHub repository:https://github.com/cocode-agency/cocode
Cocode's Competitive Comparison
| Comparison Dimensions | Cocode | Cursor |
|---|---|---|
| Product Positioning | DeepSeek Harness is an open-source distribution that emphasizes a "disassembled workspace". | An AI-native IDE based on VS Code, emphasizing an "AI-first coding experience". |
| Interface | Dual entry points: desktop GUI + terminal TUI, with interconnected session states. | A complete IDE interface (VS Code branch), without a native TUI. |
| Agent architecture | Preset offers plug-in configuration, allowing users to freely disassemble/replace tools, prompts, and permissions. | Built-in Agent capability, through .cursorrules With settings adjustments, the architecture is relatively closed. |
| open source | MIT is completely open sourceIt can be freely forked, modified, and distributed. | Closed-source commercial products, core code is not open source. |
| Model support | Switch between Nut subscriptions, DeepSeek keys, and any OpenAI-compatible endpoint at any time. | It features its own models and supports custom API keys, while deeply integrating with Cursor's model routing. |
| Workspace Concepts | The file, Git, terminal, browser, and agent all reside in one interface, while the result remains in the task queue. | Centered around the editor, with AI sidebar/Composer assistance, and file system managed natively through VS Code. |
| Security confirmation mechanism | Before writing files, executing commands, and connecting to the internet.Force pause and display the scope of impactUser confirmation is required. | It can be configured to run automatically or require confirmation. YOLO mode supports fully automatic execution, and the security boundaries are set by the user. |
| Remote/Server Scenarios | TUI supports direct SSH connection, allowing full functionality even without a graphical environment. | Requires remote desktop or VS Code Server; cannot be used in a pure terminal environment. |
Cocode application scenarios
- Remote server development and maintenanceAccess the production server or container via TUI SSH, allowing the Agent to analyze logs, modify configurations, and execute deployment scripts in a graphical interface-less environment. The GUI and TUI sessions are interconnected, enabling desktop coding and server-side verification.
- Security-sensitive enterprise intranet developmentCocode supports fully local operation with its own API key, ensuring the code remains within the intranet; critical operations require manual confirmation, making it suitable for financial and government enterprise scenarios with strict requirements for data security and operational auditing.
- Refactoring and migration of large codebasesUse a detachable Agent Preset to configure specialized toolsets and prompt word strategies for different modules; the Agent analyzes dependencies, makes batch modifications, and runs tests across files within a unified workspace, and all changes are centrally reviewed in diff form before being uniformly applied.
- Custom AI workflow orchestrationDevelopers can copy and modify the Agent Preset based on the open-source code, define their own toolkit, security boundaries and scheduling logic, and create a customized coding Agent that fits the team's specifications.