Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
TUI Mode
Run qodercli from any project root to enter the default TUI (interactive) mode. You can chat with the CLI by text or execute special functions via slash commands.
Multiple input modes are available in the TUI:
| Command | Description |
|---|
> | Dialog mode (default). Type any text to chat with the CLI. |
! | Bash mode. From dialog mode, enter ! to run shell commands directly. |
/ | Slash mode. From dialog mode, type / to open and run built-in commands. |
\ ⏎ | Enter to start multiline input. |
Slash commands
Quickly access features and settings with these built-in slash commands:
| Command | Description |
|---|
/login | Log in to your Qoder account |
/help | Show TUI help |
/init | Initialize or update the AGENTS.md memory file in the project |
/memory | Open the memory manager for user, project, and local memory files |
/quest | Spec-driven delegated task |
/review | Code review for local changes |
/resume | List and resume sessions |
/clear | Clear the current session context history |
/compact | Summarize the current session’s context history |
/usage | Show your current credit usage |
/status | Show CLI status: version, model, account, API connectivity, tool status, etc. |
/config | Show system configuration of Qoder CLI |
/agents | Subagent commands: list, create, manage subagents |
/tasks | List running background tasks |
/release-notes | Show Qoder CLI release notes |
/vim | Open an external editor to edit input |
/feedback | Send feedback about Qoder CLI |
/quit | Exit TUI |
/logout | Log out of your Qoder account |
Advanced startup options
When launching the CLI, use the following options to control its behavior:
| Command | Description | Example |
|---|
-w | Specify the workspace directory | qodercli -w /Users/demo/projects/nacos |
-c | Continue the last session | qodercli -c |
-r | Resume a specific session | qodercli -r *******-c09a-40a9-82a7-a565413fa39 |
--allowed-tools | Allow only specified tools | qodercli --allowed-tools=Read,Write |
--disallowed-tools | Disallow specified tools | qodercli --disallowed-tools=Read,Write |
--max-turns | Maximum dialog turns | qodercli --max-turns=10 |
--yolo | Skip permission checks | qodercli --yolo |
Print Mode
Print mode is non-interactive. Run qodercli --print to enter. Output is printed according to --output-format.
Flags
Global options can be used with any command:
| Option | Description | Example |
|---|
-p | Run the Agent non-interactively | qodercli -q -p hi |
--output-format | Output format: text, json, stream-json | qodercli --output-format=json |
-w | Specify the workspace directory | qodercli -w /Users/qoder_user/projects/qoder_demo |
-c | Continue the last session | qodercli -c |
-r | Resume a specific session | qodercli -r ********-c09a-40a9-82a7-a565413fa393 |
--allowed-tools | Allow only specified tools | qodercli --allowed-tools=Read,Write |
--disallowed-tools | Disallow specified tools | qodercli --disallowed-tools=Read,Write |
--max-turns | Maximum dialog turns | qodercli --max-turns=10 |
--yolo | Skip permission checks | qodercli --yolo |
Worktree
Use --worktree [name] to start a Qoder CLI session in a separate Git worktree. This is useful when you want to run parallel sessions against the same repository without sharing the same working directory.
Requirements: run the command inside a Git repository and make sure Git is installed locally.
Start in a worktree
qodercli --worktree feature-a
qodercli --worktree feature-a "Implement the login fix"
qodercli --worktree
cd <worktree-path> && qodercli --resume <session-id>
git worktree remove <worktree-path>
Memory
Qoder CLI uses AGENTS.md as a memory file, the content of which is auto-loaded into CLI as context to guide development. Typical content:
- Development standards and notes
- Overall system architecture
- …
local files path：
# User-level, applies to all projects
~/.qoder/AGENTS.md
# Project-level, applies to the current project
${project}/AGENTS.md
# Local project-level, private to your machine
${project}/AGENTS.local.md
Automatically generate
Start TUI in the target project and enter /init to generate AGENTS.md in the project directory.
Manually manage
- Create
AGENTS.md in the project and edit its content.
- In TUI, enter
/memory to manage user, project, and local memory files.
