Qoder Cli
Qoder CLI is a command-line tool similar to Claude Code, supporting various operations in the terminal, suitable for development, automation scripts, and other scenarios.
Qoder CLI is the official command-line client provided by the Qoder ([https://qoder.com/](https://qoder.com/users/sign-up?referral_code=whhACoCj9WryAtAh2HAqjvE2ppbzwWtz)) platform, supporting the following systems and architectures:
* Operating Systems: macOS, Linux, Windows (Windows Terminal recommended)
* CPU Architectures: arm64, amd64 (Windows arm64 not yet supported)
**First, click to visit (https://qoder.com/users/sign-up?referral_code=whhACoCj9WryAtAh2HAqjvE2ppbzwWtz) to register a Qoder account** for a free trial of Pro + 300 Credits
!(#)
Click the Download button in the upper right corner, select CLI, and view the installation command:
!(#)
### Installation Methods
You can install through the following methods.
1γcURL
# Install curl -fsSL https://qoder.com/install | bash# Upgrade curl -fsSL https://qoder.com/install | bash -s -- --force
2γHomebrewοΌmacOSγLinuxοΌ
brew install qoderai/qoder/qodercli --cask
3γNPM
npm install -g @qoder-ai/qodercli
After installation, run the following command.
qodercli --version
If the CLI version number like 0.1.21 is printed, the installation is successful.
Next, you can enter your created project directory and start using Qoder Cli:
cd your-project qodercli
### Log In to Your Account
When starting an interactive session with the qodercli command, you need to log in:
qodercli
You will be prompted to log in on first use:
!(#)
/login
Follow the prompts to log in with your account, here select Login with browser:
!(#)
If you don't have an account yet, you can register one at [https://qoder.com/](https://qoder.com/users/sign-up?referral_code=whhACoCj9WryAtAh2HAqjvE2ppbzwWtz) to get free Pro, or use your Google or GitHub account to register directly.
!(#)
After successful login, user information will be displayed:
!(#)
When you need to log out of Qoder, use the /logout command to exit.
# In interactive prompt/logout
To exit Qcoder Cli, use the following command:
/quit
Additionally, we can use the /model command to view and switch models:
!(#)
Next, we can start writing requirements in the input box. For example, ask it to create a Vue project. After input, Qoder will start organizing requirements and writing code:
Permission requests will appear during the process, select Allow and press Enter:
The entire project will be ready shortly.
## Qoder CLI Core Modes and Advanced Usage
### TUI Mode (Interactive Text Interface)
TUI (Text User Interface) is the default interactive mode of Qoder CLI, supporting text conversations, command execution, and other core operations. It is the main way for daily use.
#### 1. Startup Method
Execute the following command in any project root directory to enter TUI mode:
qodercli
#### 2. Input Modes
TUI provides multiple input modes for different operation scenarios. Enter the corresponding symbol to switch:
| Command Symbol | Mode Name | Description |
| --- | --- | --- |
| `>` | Conversation Mode | Default mode, enter any text to have natural conversation with CLI |
| `!` | Bash Mode | Enter `!` in conversation mode to directly run shell commands |
| `/` | Slash Mode | Enter `/` in conversation mode to call built-in function commands |
| `#` | Memory Mode | Enter `#` in conversation mode, content will be appended to the project's `AGENTS.md` memory file |
| ` + Enter` | Multi-line Input | Enter `` then press Enter to input multi-line text content |
#### 3. Built-in Tools
TUI mode has built-in common tools, no additional configuration needed to operate files/execute commands:
* Grep: File content search
* Read: Read file content
* Write: Modify/write file content
* Bash: Execute shell commands
#### 4. Core Slash Commands
Enter `/` then call the following built-in commands to quickly access CLI core functions:
| Command | Description |
| --- | --- |
| `/login` | Log in to Qoder account |
| `/help` | Display complete TUI usage help |
| `/init` | Initialize/update project's `AGENTS.md` memory file |
| `/memory` | Edit `AGENTS.md` memory file |
| `/quest` | Complete task delegation based on Spec |
| `/review` | Review local code changes |
| `/resume` | View/restore historical sessions |
| `/clear` | Clear current session's historical context |
| `/compact` | Summarize current session's historical context (condensed content) |
| `/usage` | View account status, Credits consumption, etc. |
| `/status` | View CLI status (version, model, account, API connectivity, tool status) |
| `/config` | View CLI system configuration |
| `/agents` | Sub Agent management (view/create/edit) |
| `/bashes` | View background running Bash tasks |
| `/release-notes` | View CLI update logs |
| `/vim` | Open external editor to edit input content |
| `/feedback` | Feedback CLI usage issues |
| `/quit` | Exit TUI mode |
| `/logout` | Log out current account |
### Advanced Startup Options
When starting Qoder CLI, you can customize startup behavior through the following parameters to adapt to different usage scenarios:
| Option | Description | Example |
| --- | --- | --- |
| `-w` | Specify workspace directory | `qodercli -w /Users/demo/projects/nacos` |
| `-c` | Continue last session | `qodercli -c` |
| `-r` | Restore specified historical session | `qodercli -r *******-c09a-40a9-82a7-a565413fa39` |
| `--allowed-tools` | Only allow using specified built-in tools | `qodercli --allowed-tools=READ,WRITE` |
| `--disallowed-tools` | Prohibit using specified built-in tools | `qodercli --disallowed-tools=READ,WRITE` |
| `--max-turns` | Set maximum conversation turns | `qodercli --max-turns=10` |
| `--yolo` | Skip permission checks (use with caution) | `qodercli --yolo` |
### Print Mode (Non-interactive)
Print mode is a non-interactive batch execution mode with customizable output formats, suitable for automation scripts and CI/CD scenarios.
#### 1. Startup Method
Execute the following command to enter Print mode:
qodercli --print
#### 2. Core Parameters
Print mode supports the following parameters, reusing some parameters from advanced startup options:
| Parameter | Description | Example |
| --- | --- | --- |
| `-p` | Run Agent in non-interactive way | `qodercli -q -p "Help me analyze the dependency structure of the current project"` |
| `--output-format` | Specify output format (text/json/stream-json) | `qodercli --output-format=json` |
| `-w` | Specify workspace directory | Same as advanced startup options |
| `-c` | Continue last session | Same as advanced startup options |
| `-r` | Restore specified session | Same as advanced startup options |
| `--allowed-tools` | Only allow specified tools | Same as advanced startup options |
| `--disallowed-tools` | Prohibit specified tools | Same as advanced startup options |
| `--max-turns` | Maximum conversation turns | Same as advanced startup options |
| `--yolo` | Skip permission checks | Same as advanced startup options |
* * *
## MCP Service Integration
Qoder CLI supports integrating standard MCP (Model Context Protocol) tools to extend CLI capabilities (such as browser control, third-party tool calls).
### 1. Add MCP Service
Taking Playwright (browser control) integration as an example, execute the following command:
qodercli mcp add playwright -- npx -y @playwright/mcp@latest
### 2. Manage MCP Services
| Command | Description |
| --- | --- |
| `qodercli mcp list` | List all added MCP services |
| `qodercli mcp remove playwright` | Remove specified MCP service (example is playwright) |
### 3. Advanced Configuration (Optional)
* `-t`: Set MCP service type, supports `stdio`/`sse`/`streamable-http` (Stdio type will auto-start when TUI launches);
* `-s`: Set service scope, supports "user-level" or "project-level", can customize MCP configuration per project.
### 4. MCP Service File Storage Location
Added MCP service configurations will be saved in the following files:
# Added for current user or specific project, will not be committed.~/.qoder.json # Added for current project, usually will be committed. ${project}/.mcp.json
* * *
## Reference Links:
* [https://qoder.com/](https://qoder.com/)
* [https://qoder.com/cli](https://qoder.com/cli)
* [https://docs.qoder.com/zh/cli/quick-start](https://docs.qoder.com/zh/cli/quick-start)
YouTip