https://github.com/QwenLM/qwen-code
qwen-code is a coding agent that lives in digital world.
https://github.com/QwenLM/qwen-code
Last synced: over 1 year ago
JSON representation
qwen-code is a coding agent that lives in digital world.
- Host: GitHub
- URL: https://github.com/QwenLM/qwen-code
- Owner: QwenLM
- License: apache-2.0
- Created: 2025-06-26T01:37:46.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-22T21:27:58.000Z (over 1 year ago)
- Last Synced: 2025-07-22T23:28:17.564Z (over 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 4.28 MB
- Stars: 244
- Watchers: 3
- Forks: 24
- Open Issues: 0
-
Metadata Files:
- Readme: README.gemini.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Roadmap: ROADMAP.md
Awesome Lists containing this project
- awesome-openclaw-money-maker - **Qwen Code** - Open-source AI agent that lives in your terminal, powered by Qwen. (AI Agent Frameworks / General Agent Frameworks)
- awesome - QwenLM/qwen-code - source AI coding agent that lives in your terminal. (AI)
- awesome-list - qwen-code: An open-source AI coding agent that lives in your terminal.
- Awesome-Prompt-Engineering - GitHub
- awesome-free-models - Qwen Code - source terminal AI coding agent with 27K+ stars. Multi-protocol (OpenAI, Anthropic, Gemini, Qwen). Auto-memory, sub-agents, agent teams, MCP. Apache 2.0. (๐ค AI Coding Assistants)
- awesome-agent-cli - qwen - line AI coding assistant. \ (Catalog / agent)
- awesome-ai-agents-2026 - Qwen Code - source terminal coding agent | (Coding agents / New runtime, control-plane, and physical-agent candidates)
- awesome-x-ops - Qwen Code - source AI coding agent that runs in the terminal with multi-file editing, task planning, and MCP server integration. (Platform Engineering / AI Coding Tools)
- awesome-ai-coding - Qwen Code - ref] | Subscription | 2,000 req / day | - | Yes | Yes | (CLI)
- awesome-agent-harness - Qwen Code - 07 | Alibaba | Yes | (Agent Harness ๐ / 5. The Convergence: Harness-as-a-Service (HaaS))
- awesome-vibe-coding - Qwen Code - source coding CLI optimized for Qwen coder models. | (CLI & Terminal Tools / AI Coding CLIs)
- awesome-claude-code - **qwen-code** - line AI workflow tool adapted from Gemini CLI, optimized for Qwen3-Coder models with enhanced parser support & tool support. (Alternatives to Claude Code)
- awesome-cli-agents - QwenLM/qwen-code - An open-source AI coding agent that lives in your terminal. [Terminal] (28kโญ) (๐ AI Tools for Vim, Neovim, and Terminal)
- awesome-vibe-coding-tools - qwen-code - based coding agent from Alibaba Cloud that lives in the digital world. Features full codebase awareness, OAuth authentication, multi-model support, and strong code understanding capabilities. Supports code generation, debugging, and refactoring with 1M context window and vision model integration. (๐ป Terminal-Based AI Agents)
- awesome-typescript - QwenLM/qwen-code - An open-source AI coding agent that lives in your terminal. (Machine Learning and AI / LLM and Inference)
- awesome-ai-coding - Qwen Code - โ AI Coding CLI Agents (๐ Changelog / 2026-09-19 โ Weekly Update)
- awesome-ai-pulse-georgia - Qwen Code - แก Qwen แแฃแแแแก แแคแแชแแแแฃแ แ, แฆแแ แแแแแก terminal coding agent-แแ. TypeScript-แจแ แแแฌแแ แแแ, OpenAI-แแแแกแแแแแ API-แแก แกแขแแแแแ แขแแ แแฃแจแแแแก โ แแแฃ Anthropic-แแก, OpenAI-แแก แแ Google-แแก แแแแแแแแแช แฉแแ แแฃแแแ. Qwen 3 แแแแแแแแแ แแแแกแแแฃแแ แแแแ แแแ แแแ แแแแแแแแก แแแแแแแชแแแกแ แแ แแแขแแแแขแแแแชแแแจแ. Claude Code-แแกแ แแ Gemini CLI-แแก แแแแแฃแ แแแขแ Alibaba-แก แแแแกแแกแขแแแแแแ. | (๐ค แแแแแแ แแแแแขแแแ)
- awesome-llm - QwenLM/qwen-code - An open-source AI coding agent that lives in your terminal. (AI Agents / Agent Frameworks and Runtimes)
- awesome-AI-driven-development - Qwen Code - AI-powered command-line workflow tool for developers (Terminal & CLI Agents)
- awesome-solo-founder-oss - Qwen Code - source terminal coding agent | (AI agents and MCP / Product marketing stack)
- awesome-terminals-ai - Qwen Code CLI - Official AI-powered workflow tool for general tasks, optimized for Qwen3-Coder models. Features conversation management and session control. Offers Qwen OAuth with 2,000 free requests/day. (AI Coding Assistants & Agents / Provider-Native Coding CLIs)
- AiTreasureBox - QwenLM/qwen-code - 02-24_19340_63](https://img.shields.io/github/stars/QwenLM/qwen-code.svg)|An open-source AI agent that lives in your terminal.| (Repos)
- awesome-ai-agent-stack - QwenLM/qwen-code - Alibaba's open-source terminal coding agent with MCP support. (Coding Agents & Harnesses)
- FreeTools - Qwen Code - line AI workflow tool adapted from Gemini CLI, specifically optimized for Qwen3-Coder models. (AI driven development)
- awesome-joingonka - Qwen Code - Open-source terminal coding agent by the Qwen team with OpenAI-compatible model providers. Guide: <https://joingonka.ai/en/knowledge/qwen-code> (Coding Agents)
- awesome-github-projects - qwen-code - An open-source AI coding agent that lives in your terminal. โญ28,435 `TypeScript` ๐ฅ (๐ค AI & Machine Learning)
- github-ultimate-repos - QwenLM/qwen-code - ย |ย โญ 28,707โ ย |ย ๐ด 3,258 ย |ย ๐ป `TypeScript`๐ <https://github.com/QwenLM/qwen-code>๐ An open-source AI coding agent that lives in your terminal.โ๏ธ `BPE/SentencePiece tokenization -> RoPE positional rotation -> FlashAttention-2 KV-cache -> fused quantized GEMM execution -> Softmax top-p sampling.` (๐ Master Categorized Repository Directory (100% Clickable Links) / [02] ARTIFICIAL INTELLIGENCE, LARGE LANGUAGE MODELS, FOUNDATION MODELS & QUANTIZATION)
- awesome-ai-dev-tools - Qwen Code - An open-source terminal AI coding agent optimized for Qwen models, with multi-provider support, built-in tools, skills, sub-agents, and IDE integrations. (๐ Tools / ๐ What You'll Find Here:)
- awesome-ai-agents-2026 - Qwen Code - ใขใชใใ Qwen ใใผใ ใฎใชใผใใณใฝใผในใฟใผใใใซใณใผใใฃใณใฐใจใผใธใงใณใ โ ใจใผใธใงใณใใใผใ ใ่ชๅใกใขใชใIDE ็ตฑๅใใใซใใใญใใคใ๏ผOpenAI / Anthropic / Gemini / Qwen๏ผใ26K+ starsใ (๐จ๐ณ ไธญๅฝ AI ใจใณใทในใใ / ้็บ่ ใใผใซ)
- awesome-selfhosted-ai - Qwen Code - Terminal coding agent tuned for Qwen models and compatible with other OpenAI-style APIs. (Coding Assistants)
- awesome-opensource-ai - Qwen Code - Open-source AI agent for the terminal, optimized for Qwen series models. Multi-protocol provider support including OpenAI, Anthropic, Gemini, Alibaba Cloud, OpenRouter. Features agentic workflow with Skills and SubAgents. Apache 2.0 licensed.  (13. Developer Tools & Integrations)
- awesome-mcp-servers - Qwen Code - Alibaba's open-source terminal coding agent (Clients)
- awesome - QwenLM/qwen-code - An open-source AI coding agent that lives in your terminal. (TypeScript)
- awesome-vibe-coding - Qwen Code - Alibaba's open-source terminal agent for Qwen and compatible models. (AI Coding Assistants / CLI Tools)
- awesome-cli-coding-agents - Qwen Code - 2.0. (Terminal-native coding agents / Open Source)
- awesome-agent-harness - GitHub - 25399-f4b400?style=flat-square)](https://github.com/QwenLM/qwen-code) | terminal, coding-agent, cli | Terminal-native open-source coding agent tuned for practical dev loops. | (Catalog / Reference Harness Implementations)
- awesome-agent-evolution - **Qwen Code** - Open-source AI coding agent that lives in your terminal, optimized for Qwen-Coder models. by [@QwenLM](https://github.com/QwenLM) (28,476 stars) (Agent Coding and Software Engineering)
- awesome-ai-tools - Qwen Code - brightgreen) | Claude-Code feature-parity (subagents, skills, plan mode) on open models โ fully free with BYO-key. | (โก Quick Picks)
- awesome-ai-200 - QwenLM/qwen-code
- awesome-ai-agents - QwenLM/qwen-code - Open-source terminal coding agent from the Qwen team with subagents, skills, hooks and MCP support, speaking the OpenAI, Anthropic, Gemini and Qwen API formats plus local model runtimes. (Developer & Coding Assistants / Code Generation & Refactoring)
- awesome-mcp - QwenLM/qwen-code - Open-source terminal coding agent in TypeScript from the Qwen team that consumes MCP servers as tool providers, alongside subagents, skills, hooks, IDE plugins and support for OpenAI, Anthropic, Gemini and Qwen APIs. (MCP Clients / CLI Tools)
- awesome-ai-agents - Qwen Code - source terminal-native AI coding agent. Powered by Qwen models with MCP support, 25K+ stars, and Apache-2.0 license. (Frameworks & Libraries / Code Agents)
- awesome - QwenLM/qwen-code - An open-source AI coding agent that lives in your terminal. (TypeScript)
- awesome-ai-tuis - **Qwen Code** - source terminal coding agent tuned for Qwen-Coder models. | ๐ง Agentic ยท ๐ TypeScript ยท ๐ Multi-provider ยท ๐ MCP ยท ๐ค Sub-agents | (๐ The List)
- awesome-vibe-coding - QwenLM/qwen-code - "qwen-codeๆฏไธไธช็ๆดปๅจๆฐๅญไธ็็็ผ็จไปฃ็"ใ (ๅฝไปค่กๅทฅๅ ท)
- awesome-coding-agent - Qwen Code - **27.7k stars** ยท `CLI` ยท `Apache-2.0`. A terminal coding agent from the Qwen team with repository editing, shell tools, MCP support, and headless operation. (Ranked AI Coding Agents)
README
# Gemini CLI
[](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml)

This repository contains the Gemini CLI, a command-line AI workflow tool that connects to your
tools, understands your code and accelerates your workflows.
With the Gemini CLI you can:
- Query and edit large codebases in and beyond Gemini's 1M token context window.
- Generate new apps from PDFs or sketches, using Gemini's multimodal capabilities.
- Automate operational tasks, like querying pull requests or handling complex rebases.
- Use tools and MCP servers to connect new capabilities, including [media generation with Imagen,
Veo or Lyria](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
- Ground your queries with the [Google Search](https://ai.google.dev/gemini-api/docs/grounding)
tool, built in to Gemini.
## Quickstart
1. **Prerequisites:** Ensure you have [Node.js version 20](https://nodejs.org/en/download) or higher installed.
2. **Run the CLI:** Execute the following command in your terminal:
```bash
npx https://github.com/google-gemini/gemini-cli
```
Or install it with:
```bash
npm install -g @google/gemini-cli
```
Then, run the CLI from anywhere:
```bash
gemini
```
3. **Pick a color theme**
4. **Authenticate:** When prompted, sign in with your personal Google account. This will grant you up to 60 model requests per minute and 1,000 model requests per day using Gemini.
You are now ready to use the Gemini CLI!
### Use a Gemini API key:
The Gemini API provides a free tier with [100 requests per day](https://ai.google.dev/gemini-api/docs/rate-limits#free-tier) using Gemini 2.5 Pro, control over which model you use, and access to higher rate limits (with a paid plan):
1. Generate a key from [Google AI Studio](https://aistudio.google.com/apikey).
2. Set it as an environment variable in your terminal. Replace `YOUR_API_KEY` with your generated key.
```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```
3. (Optionally) Upgrade your Gemini API project to a paid plan on the API key page (will automatically unlock [Tier 1 rate limits](https://ai.google.dev/gemini-api/docs/rate-limits#tier-1))
### Use a Vertex AI API key:
The Vertex AI API provides a [free tier](https://cloud.google.com/vertex-ai/generative-ai/docs/start/express-mode/overview) using express mode for Gemini 2.5 Pro, control over which model you use, and access to higher rate limits with a billing account:
1. Generate a key from [Google Cloud](https://cloud.google.com/vertex-ai/generative-ai/docs/start/api-keys).
2. Set it as an environment variable in your terminal. Replace `YOUR_API_KEY` with your generated key and set GOOGLE_GENAI_USE_VERTEXAI to true
```bash
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
```
3. (Optionally) Add a billing account on your project to get access to [higher usage limits](https://cloud.google.com/vertex-ai/generative-ai/docs/quotas)
For other authentication methods, including Google Workspace accounts, see the [authentication](./docs/cli/authentication.md) guide.
## Examples
Once the CLI is running, you can start interacting with Gemini from your shell.
You can start a project from a new directory:
```sh
cd new-project/
gemini
> Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide
```
Or work with an existing project:
```sh
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday
```
### Next steps
- Learn how to [contribute to or build from the source](./CONTRIBUTING.md).
- Explore the available **[CLI Commands](./docs/cli/commands.md)**.
- If you encounter any issues, review the **[troubleshooting guide](./docs/troubleshooting.md)**.
- For more comprehensive documentation, see the [full documentation](./docs/index.md).
- Take a look at some [popular tasks](#popular-tasks) for more inspiration.
- Check out our **[Official Roadmap](./ROADMAP.md)**
### Troubleshooting
Head over to the [troubleshooting guide](docs/troubleshooting.md) if you're
having issues.
## Popular tasks
### Explore a new codebase
Start by `cd`ing into an existing or newly-cloned repository and running `gemini`.
```text
> Describe the main pieces of this system's architecture.
```
```text
> What security mechanisms are in place?
```
### Work with your existing code
```text
> Implement a first draft for GitHub issue #123.
```
```text
> Help me migrate this codebase to the latest version of Java. Start with a plan.
```
### Automate your workflows
Use MCP servers to integrate your local system tools with your enterprise collaboration suite.
```text
> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.
```
```text
> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.
```
### Interact with your system
```text
> Convert all the images in this directory to png, and rename them to use dates from the exif data.
```
```text
> Organize my PDF invoices by month of expenditure.
```
### Uninstall
Head over to the [Uninstall](docs/Uninstall.md) guide for uninstallation instructions.
## Terms of Service and Privacy Notice
For details on the terms of service and privacy notice applicable to your use of Gemini CLI, see the [Terms of Service and Privacy Notice](./docs/tos-privacy.md).