Get help fast → Join Discord • Prefer async? → Join r/ZooCode
Your AI-Powered Dev Team, Right in Your JetBrains IDE
Zoo Code for JetBrains brings the Zoo Code AI coding assistant to IntelliJ-based IDEs. It runs the Zoo Code extension through a bundled extension host and integrates it with JetBrains editors, terminals, menus, and tool windows.
Zoo Code continues development of this project after the Roo team wound down active Roo Code work to focus on Roomote. We thank the Roo team for everything they built.
The core Zoo Code team includes developers who previously contributed to Roo and care deeply about this plugin. We will continue to make model updates, fix bugs, release features, and listen closely to the community. Join us on Discord, Reddit, or open a pull request or issue.
- Zoo Code Team
Migrating from Roo Code? See the Roo → Zoo migration guide. If you need help during the transition, ask the community on Discord or Reddit.
- OpenAI GPT-5.6 family — Sol, Terra, and Luna are available through the OpenAI Codex and OpenAI Native provider paths.
- Grok 4.5 support — use xAI's latest flagship model, with improved reasoning-effort formatting for Grok 4 Mini.
- Kenari provider support — use an OpenAI-compatible AI gateway billed in Rupiah, with access to Claude, GPT, DeepSeek, GLM, Kimi, and more.
- Access context compaction and context-window progress from the collapsed task header.
- Fixes for terminal output loss and premature task completion on cold terminals.
- Live vision-capability detection for image attachments with Zoo Gateway and Vercel AI Gateway models.
- Dependency and tooling updates.
- Generate code from natural-language descriptions and specifications
- Adapt through Code, Architect, Ask, Debug, and Custom modes
- Refactor and debug existing code
- Write and update documentation
- Answer questions about your codebase
- Automate repetitive tasks
- Use Model Context Protocol (MCP) servers
Zoo Code adapts to how you work:
- Code Mode: everyday coding, edits, and file operations
- Architect Mode: plan systems, specifications, and migrations
- Ask Mode: get fast answers, explanations, and documentation
- Debug Mode: trace issues, add logs, and isolate root causes
- Custom Modes: create specialized modes for your team or workflow
Learn more: Using Modes • Custom Modes
Zoo Code supports JetBrains IDEs based on the IntelliJ Platform, including:
- IntelliJ IDEA (Ultimate and Community)
- WebStorm
- PyCharm (Professional and Community)
- PhpStorm
- RubyMine
- CLion
- GoLand
- DataGrip
- Rider
- Android Studio 2026.1.4 or newer (currently available as a preview)
The plugin targets IntelliJ Platform build 233 (JetBrains 2023.3) or newer. Android Studio requires version 2026.1.4 or newer because that release includes the JCEF support required by Zoo Code. At present, Android Studio 2026.1.4 is available through the preview channel.
- A supported JetBrains IDE based on IntelliJ Platform build 233 or newer
- Android Studio 2026.1.4 or newer when using Android Studio; install a preview build until this version reaches the stable channel
- A JCEF-enabled IDE runtime, which Zoo Code requires to render its interface
- Node.js 20.6.0 or newer available on your
PATH
- Node.js 20.6.0 or newer and npm
- JDK 17 or newer
- Git
- Bash
curlorwgetunzip
- Download the latest plugin ZIP from the GitHub Releases page.
- Open your JetBrains IDE.
- Go to Settings/Preferences → Plugins.
- Select the gear icon, then Install Plugin from Disk....
- Choose the downloaded
.zipfile. - Restart the IDE when prompted.
- Open the Zoo Code JetBrains tool window from the right sidebar.
git clone https://github.com/Zoo-Code-Org/Zoo-Code-Jetbrains.git
cd Zoo-Code-Jetbrains
# Initialize submodules and install dependencies
./scripts/setup.sh
# Download the latest Zoo Code extension and build the plugin
./scripts/build.shThe installable plugin is written to the dist/ directory. Install that ZIP through Settings/Preferences → Plugins → Install Plugin from Disk....
The setup script handles:
- Git LFS initialization
- Git submodule initialization and updates
- Dependency installation
- Patch application
- Development environment setup
The build script then:
- Downloads the latest Zoo Code extension from the VS Code Marketplace
- Builds the Extension Host runtime
- Builds the JetBrains plugin with Zoo Code integrated
- Writes a ready-to-install plugin to the
dist/directory
# Release build (default)
./scripts/build.sh
# Debug build with source maps
./scripts/build.sh --mode debug
# Custom output directory
./scripts/build.sh --output ./my-build
# Clean build
./scripts/build.sh --clean
# Use an existing downloaded extension
./scripts/build.sh --skip-download
# Skip individual components
./scripts/build.sh --skip-host
./scripts/build.sh --skip-idea
# Verbose output
./scripts/build.sh --verbose
# Show all options
./scripts/build.sh --helpAfter a full build, the output directory contains:
ZooCode-*.zip— installable JetBrains pluginextension_host/— compiled Extension Host runtimedebug-resources/— debug resources, when using debug modeREADME.md— generated installation instructions
For more build-system details, see BUILD.md.
cd extension_host
npm install
npm run build:extension # Production build
# or
npm run build # Development buildcd jetbrains_plugin
# Production build with Zoo Code
./gradlew -PdebugMode=release -PvscodePlugin=zoo-code buildPlugin
# Debug build
./gradlew -PdebugMode=idea -PvscodePlugin=zoo-code buildPlugincd jetbrains_plugin
./gradlew runIde./scripts/test.shThe integration consists of three main components:
- JetBrains Plugin (Kotlin): integrates editors, terminals, commands, menus, webviews, and tool windows with the IDE.
- Extension Host (Node.js): provides a VS Code-compatible runtime for Zoo Code.
- Zoo Code Extension: supplies the AI assistant experience and is downloaded from the VS Code Marketplace during a full build.
The JetBrains plugin communicates with the Extension Host using RPC over Unix-domain sockets on macOS and Linux, or named pipes on Windows.
- Confirm Node.js 20.6.0 or newer is installed with
node --version. - Make sure Node.js is available on the IDE process
PATH. - Restart the IDE after installing the plugin.
- Review the JetBrains IDE log for Zoo Code or Extension Host errors.
- See Known Issues.
# Reinitialize the project
./scripts/setup.sh --force
# Verify prerequisites
node --version
java --version
# Ensure scripts are executable
chmod +x scripts/*.sh scripts/lib/*.sh jetbrains_plugin/gradlew
# Clean and rebuild
./scripts/build.sh --clean --verboseDownload the Zoo Code VSIX, extract it to jetbrains_plugin/plugins/zoo-code/extension/, and build with:
./scripts/build.sh --skip-download- Documentation: Install, configure, and master Zoo Code.
- Zoo Code repository: Follow development of the core extension.
- YouTube channel: Watch tutorials and feature demonstrations.
- Discord server: Get real-time help and join community discussions.
- Reddit community: Share your experience and see what others are building.
- JetBrains integration issues: Report integration-specific bugs.
- Zoo Code issues: Report issues with the core extension.
- Feature requests: Propose and discuss ideas.
Community contributions are welcome. Read CONTRIBUTING.md before opening a pull request.
Apache License 2.0 © 2026 Zoo Code Org
Enjoy Zoo Code! Whether you keep it on a short leash or let it roam autonomously, we cannot wait to see what you build. If you have questions or feature ideas, visit Reddit, join Discord, or open an issue. Happy coding!