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.
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.
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.
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.
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.
MCP & extensions
Connect MCP servers to add tools for AI. Install extensions from Open VSX for the languages and workflows you need.
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.
Review image · Add a prompt · Send to AI
- 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.
- 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.
- Review the attachment in chat, add your prompt, then send it to an image-capable model.
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.
Configured around the way you work
- Open AI Configuration → API Keys and select Connect for your provider.
- For Custom, choose Add endpoint. Enter a name, URL, API key and the matching API type.
- Select the endpoint’s models, save, then use them in chat or Model Aliases.
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.
Configured around the way you work
- Open AI Configuration → HuyCompose. Add models to the Text model or Vision model pool.
- Use the up/down controls to set priority. Enable streaming or adjust 8 Universal Thinking effort levels directly in the chat toolbar.
- Select HuyCompose in chat or for the alias your agent uses.
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.
Configured around the way you work
- Open Model Aliases, select an alias such as default/code and choose its model.
- Open Agents, select an agent and set Language Model under LLM Requirements.
- Check Evaluates to and Agents using this Alias to confirm your setup.
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.
Hooks: partial support
- Open AI Configuration → Skills to browse skills and Curated Skill Plugins.
- Install Superpowers from the list if needed, then inspect the Compatibility table.
- Open a skill to read its instructions and use the relevant skill for your task.
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.
Configured around the way you work
- Open any project or switch workspaces instantaneously without window reload — the Rust core indexes your repository and syncs Git worktree ChangeSets.
- Follow structured ThinkingReasoning blocks, collapsible ToolGroups, live TodoLists, and the interactive ChangelogTimeline in chat.
- 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.