❓ 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. Gemini has a generous free tier, and Claude charges per token. This means NO MESSAGE LIMITS and you only pay for what you actually use.
What's the difference between free and Pro?
The free version includes basic chat functionality. Pro unlocks: AI provider switching, custom coding rules, reply to messages, folder indexing (200K context), and agentic workflows.
Can I use this with the free Gemini API?
Absolutely! Gemini offers a generous free tier that works perfectly with this extension. You can code for free with no message limits.
How do I get started?
1) Install the extension from VS Code Marketplace, 2) Get a free Gemini API key or Claude API key, 3) Enter your API key in the extension settings, 4) 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. The most recently indexed folder is used for agentic workflows.
What are agentic workflows?
Agentic workflows let AI create a detailed plan before making changes. You review and approve the plan, then AI executes it. This ensures precision and control.
Can I undo changes made by agentic workflows?
Yes! All changes are made to your files, so you can undo them with Ctrl+Z (Cmd+Z on Mac) just like any other edit.
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.