GET STARTED

Meet your new workspace.

From your first setup to your first AI task in a real project.

Install & get started

Download the HuyIDE build for your operating system. Open the app, complete the initial setup, then open your project folder to begin.

If a build is not available yet, use the registration section on the download page for updates.
Choose your download

Connect AI & HuyCompose Pool

Sign in with a Premium x1 / x3 account to use built-in Cloud AI usage pools (auto-refreshing every 4 hours & weekly), or open AI Provider Hub to connect your own API keys (BYOK), provider accounts, or a running local service such as Ollama.

Premium x1 & x3 plans include built-in 4-hour and weekly Cloud AI usage pools. When using BYOK, model charges and data handling depend on your chosen provider.

Work with agents & Universal Thinking

Open chat in your workspace, describe the desired outcome, and adjust the Universal Thinking toggle (8 reasoning effort levels). The Hybrid Rust Core Engine (ai-rust-core) indexes your repository context automatically. Follow progress through structured ThinkingReasoning, ToolGroup, and TodoList views.

You can delegate parts of the work to subagents or scan the Mobile Remote Control QR code to monitor and steer your session from your phone.

Check in the browser

Run your web project, open its address in the integrated browser, and ask AI to check specific interactions. Describe the action and expected result so the agent has a clear target.

Image understanding depends on your selected model or HuyCompose configuration.

Review changes & Git ChangeSets

Inspect the interactive ChangelogTimeline and changed files synced in real time with your Git worktree. Run the checks appropriate to your project, compare the behavior with your request, then commit using Git.

Applying changes and committing them are separate steps. Always check Git to see what will enter your commit.

MCP & extensions

Connect MCP servers to add tools for AI. Install extensions from Open VSX for the languages and workflows you need.

Review each tool's configuration and access before using it with your project.

NEW / CMD + CMD

Quick capture. Straight into chat.

Press left Cmd + right Cmd together on macOS to capture an application window and attach it to HuyIDE chat. Add a prompt to help AI understand a UI, investigate a bug, or assist with code changes.

HuyIDE / Quick capture
⌘ left + ⌘ right
Application windowPNG
Screenshot attached in chat

Review image · Add a prompt · Send to AI

Quick capture workflow illustration
  1. Run Enable Global Screenshot Shortcut in the Command Palette. Grant HuyIDE Accessibility and Screen Recording permissions in macOS settings; enable the shortcut again or restart the app if requested.
  2. Open the window to capture, such as Safari, then press left Cmd + right Cmd together. When you return to HuyIDE, the last external window is the capture source.
  3. Review the attachment in chat, add your prompt, then send it to an image-capable model.
Hold both Cmd keys together, rather than double-tapping one key. The image is attached for review before sending. Windows/Linux use left Ctrl + right Ctrl; on Wayland, use Capture Screenshot to Chat and the system source picker.

01 / ACCOUNTS & APIs

Your AI. Connected in one place.

Sign in to providers with your existing accounts, add API keys, or use local models. Manage multiple OpenAI-compatible and Anthropic-compatible endpoints inside HuyIDE.

AI Configuration
AI Provider Hub
ChatGPT accountConnected
Claude accountConnected
OpenAI-compatibleAPI
Anthropic-compatibleAPI
OllamaLocal

Configured around the way you work

Configuration illustration · Example data
  1. Open AI Configuration → API Keys and select Connect for your provider.
  2. For Custom, choose Add endpoint. Enter a name, URL, API key and the matching API type.
  3. Select the endpoint’s models, save, then use them in chat or Model Aliases.
Connection methods vary by provider. Model limits and charges belong to your account or provider.

02 / HUYCOMPOSE · PRO & PREMIUM

A model hits its limit. Your next choice is ready.

Use built-in 4-hour and weekly Cloud AI usage pools or put your BYOK models in priority order. When a model fails or hits a rate limit, HuyCompose tries the next model in separate Text and Vision pools — complete with a Universal Thinking toggle and 8 reasoning effort levels.

AI Configuration
HuyCompose / Smart Pool
01 · Cloud AI Pool (4h/7d)ACTIVE
02 · Backup BYOK modelREADY
03 · Thinking Effort (1-8)MAX

Configured around the way you work

Configuration illustration · Example data
  1. Open AI Configuration → HuyCompose. Add models to the Text model or Vision model pool.
  2. Use the up/down controls to set priority. Enable streaming or adjust 8 Universal Thinking effort levels directly in the chat toolbar.
  3. Select HuyCompose in chat or for the alias your agent uses.
Premium x1 & x3 include built-in 4-hour and weekly Cloud AI usage pools. With BYOK, an available backup model is required.

03 / MODELS FOR EACH AGENT

The right model for each agent.

Assign a model or alias to each agent. Change an alias once to update the agents sharing it, or point it at HuyCompose to use your fallback pool.

AI Configuration
default/code → HuyCompose
Coderdefault/code
Architectdefault/code
Code Reviewerdefault/code

Configured around the way you work

Configuration illustration · Example data
  1. Open Model Aliases, select an alias such as default/code and choose its model.
  2. Open Agents, select an agent and set Language Model under LLM Requirements.
  3. Check Evaluates to and Agents using this Alias to confirm your setup.
Changing an alias updates the model selection for every agent using it.

04 / SUPERPOWERS & SKILLS

Give your agents a way of working.

Skills provide reusable instructions. The Superpowers integration maps reading, editing, terminal, delegation and web tools to HuyIDE’s tools.

AI Configuration
Superpowers · 13/13 tools
Read / EditWorkspace
BashTerminal
TaskSubagents
WebSearch / WebFetchWeb tools

Hooks: partial support

Configuration illustration · Example data
  1. Open AI Configuration → Skills to browse skills and Curated Skill Plugins.
  2. Install Superpowers from the list if needed, then inspect the Compatibility table.
  3. Open a skill to read its instructions and use the relevant skill for your task.
All 13 tool mappings are supported. Pre/post action hooks are acknowledged but are not executed.

05 / RUST CORE & MOBILE REMOTE

Hybrid Rust speed. Mobile remote control.

The Hybrid Rust N-API Core Engine (ai-rust-core) paired with a Browser WASM Accelerator powers instant RepoMap indexing, code skeletonization, BPE token counting, real-time Git worktree ChangeSet timelines, and Shell AST safety checks. Scan a QR code to monitor and control live sessions from your phone via gateway.huyide.pro.

Rust Core & Remote
ai-rust-core + gateway.huyide.pro
ai-rust-core (N-API + WASM)NATIVE
Git Worktree ChangeSetSYNCED
Shell AST GuardianACTIVE
Mobile PWA (QR Relay)ONLINE

Configured around the way you work

Configuration illustration · Example data
  1. Open any project or switch workspaces instantaneously without window reload — the Rust core indexes your repository and syncs Git worktree ChangeSets.
  2. Follow structured ThinkingReasoning blocks, collapsible ToolGroups, live TodoLists, and the interactive ChangelogTimeline in chat.
  3. Open Mobile Remote Control from the status bar and scan the QR code on your phone to stream chat, inspect file diffs, and send prompts remotely.
Mobile remote control uses a persistent auto-reconnecting WebSocket relay and scopes file diffs to the active chat session.