❓ Frequently Asked Questions
Common questions about HalCode AI Assistant
Do I need to pay for API usage separately?
Yes. You provide your own API keys (Gemini or Claude), so you pay the AI provider directly for usage. Free tier includes daily caps of 10 chat messages, 5 inline completions, and 5 terminal commands. Pro unlocks unlimited use.
What's the difference between Free and Pro?
Free: 10 chat messages/day, 5 inline completions/day, 5 terminal commands/day, project memory, and model switching. Pro ($8.99/mo, $89/yr, $149 lifetime): Unlimited use, folder indexing (200K context), MCP tools, custom coding rules, and a future web version on the same license (works on 3 machines).
What is Proactive Code Analysis?
NEW in v2.3.0! AI automatically analyzes your code as you type and shows warnings with yellow squiggly lines - just like VS Code's built-in diagnostics. It detects missing imports, error handling issues, deep nesting, and long functions. Click the lightbulb to apply quick fixes!
How does Inline Code Completion work?
Like GitHub Copilot! As you type, AI suggests code completions based on your context. Press Tab to accept, Esc to dismiss. Free tier: 5 completions/day, Pro: unlimited.
Can AI run terminal commands?
Yes! AI can execute commands with your approval. It can run tests, install dependencies, build projects, and more. You review and approve each command before execution. Safety checks prevent dangerous commands. Free tier: 5 commands/day, Pro: unlimited.
What is Workspace Search?
Search your entire codebase instantly! Find functions, classes, API endpoints, TODOs, and more with fuzzy matching and regex support. Results include context lines. Works across all file types. Unlimited searches even on free tier!
Can I use this with the free Gemini API?
Absolutely! Gemini offers a generous free tier that works perfectly with your own API key.
How do I activate my Pro license after purchase?
After purchase, your license key is emailed to you. To activate, open the VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and run 'AI Assistant: Enter License Key'.
How do I get started?
1) Install the extension from VS Code Marketplace, 2) Set up your API key in settings, 3) Start coding with AI!
What if I want to cancel?
Monthly and yearly subscriptions can be cancelled anytime. You'll keep access until the end of your billing period. Lifetime licenses never expire.
Can I use both Claude and Gemini?
Yes! You can store both API keys and switch between them instantly. No need to re-enter credentials.
Is my API key secure?
Yes. Your API keys are stored in VS Code's secure storage system, which uses your operating system's credential manager. We never see or store your keys.
What is folder indexing?
Folder indexing scans your entire codebase and creates an optimized context (200K tokens) that AI uses to understand your project structure, dependencies, and patterns.
How long does folder indexing take?
It depends on your project size. Small projects (< 1000 files) usually take a few seconds. Large projects may take 30-60 seconds.
Can I index multiple folders?
Yes! You can index different folders for different projects.
What is Project Memory?
Project Memory (.halcode/memory.md) automatically saves your goals, plans, and completed file progress so context is preserved across chat sessions.
How do I create custom rules?
Open HalCode settings, click 'Custom Rules', and add your rules. Be specific and clear. AI will follow these rules when generating code.
Can I export my conversations?
Yes! You can export conversations to Markdown, JSON, or HTML formats. Perfect for documentation, sharing, or backup.
Is there a trial?
Yes! All Pro features are free for 7 days. After that, you can subscribe to continue using Pro features.