ValorIDE README
Agentic Coder, Powered by ThorAPI ⚡
| Download on VS Marketplace | Feature Requests | Getting Started |
|---|
What is Valor IDE?
Valor IDE is your agentic coding companion inside VS Code.
Unlike traditional "autocomplete" assistants, Valor IDE can actually use your CLI and Editor — giving it hands-on power to build, debug, and ship your code alongside you.
Built on ThorAPI's secure generation engine and Claude Opus agentic capabilities, Valor IDE is more than code completion:
- It analyzes your project with AST parsing, regex search, and source tree exploration.
- It edits files, fixes errors, installs dependencies, and runs commands.
- It can launch a browser, click around, capture console logs/screenshots, and fix UI bugs.
- It extends itself with the Model Context Protocol (MCP) to add brand-new tools.
- Every action is human-in-the-loop: you approve edits and commands, keeping safety + control in your hands.
In short: Valor IDE is the future of coding—accessible, agentic, and always under your command.
How It Works
-
Define a Task
- Example: "Fix this bug" or "Convert this mockup into a working app."
- You can even add screenshots or errors from your workspace.
-
Valor IDE Gathers Context
- Scans your project structure.
- Reads files and ASTs.
- Decides what's relevant without overwhelming the context window.
-
Agentic Execution
- Creates/edits files with diffs.
- Runs commands in your terminal and adapts to live output.
- For web projects, launches a headless browser to test/debug.
-
Review & Approve
- You see the diffs. You approve or revert.
- Valor IDE learns and continues until the task is complete.
[!TIP] Use the
CMD/CTRL + Shift + Pshortcut to open the command palette and type "ValorIDE: Open In New Tab" to open the extension as a tab in your editor. This lets you use ValorIDE side-by-side with your file explorer, and see how he changes your workspace more clearly.
Core Features
🔗 Use Any API & Model
Valor IDE integrates with OpenRouter, Anthropic, OpenAI, Google Gemini, AWS Bedrock, Azure, GCP Vertex, or local models (Ollama / LM Studio).
It also tracks token usage and costs across entire task loops, so you always know your spend.
🛠️ Valhalla Suite / ThorAPI
Valor IDE integrates with the rest of the Valhalla Suite from Valkyr Labs -- ThorAPI generated backend apis, Typescript (and other) client libraries and components.
Full Application Generation:
- Generate complete applications from OpenAPI specifications
- Poll generation status and download completed projects
- Configurable ThorAPI output folders via
.valoride/config - Seamless integration with generated Spring Boot backends and React frontends
ValkyrAI can be run as a service in your generated application stack, providing workflow automations, while built-in RBAC allows secure sharing of any object in the system.
Agentic reporting tracks token usage and costs across entire task loops, so you always know your spend and monetization features of the ValkyrLabs.com
💳 ValorIDE Account Management
For ValorIDE account users, the extension provides comprehensive billing and usage tracking:
- Credit Balance Monitoring: Real-time balance display and transaction history
- Usage Analytics: Detailed breakdown of token usage and costs per task
- Payment History: Complete transaction records and billing management
- ContentData Integration: Access to enhanced content and data services
💻 Run Terminal Commands
With VS Code's new Shell Integration API, Valor IDE can:
- Install packages, run builds, deploy, and test.
- Handle long-running servers with background monitoring.
- React dynamically to compile errors and environment issues.
📝 Create & Edit Files
- Edits appear in VS Code's diff view.
- You can modify or reject changes instantly.
- Valor IDE proactively fixes syntax/linter/compiler errors.
- Every change is recorded in your file's Timeline for easy rollback.
🌐 Enhanced Browser Automation
With Claude Sonnet's Computer Use:
- Launches a browser, clicks, types, scrolls.
- Captures screenshots and console logs.
- Local Chrome Integration: Connect to your existing Chrome browser for session-based debugging.
- Browser Discovery: Automatically detect and connect to running Chrome instances.
- Perfect for runtime debugging and fixing UI bugs.
🛠️ Extend with MCP
Valor IDE can generate new Model Context Protocol (MCP) tools on the fly.
Example prompts:
add a tool that fetches Jira ticketsadd a tool that manages AWS EC2sadd a tool that pulls PagerDuty incidents
Advanced MCP Features:
- MCP Marketplace: Discover and install curated MCP servers directly from the extension
- Remote MCP Servers: Connect to MCP servers via Server-Sent Events (SSE)
- Rich Responses: Automatic image previews, website thumbnails, and data visualizations
- Auto-Approval Settings: Configure which MCP tools require approval
These tools become part of Valor IDE's toolkit, ready for future use.
📂 Advanced Context & Mentions
@url→ fetch a URL and convert docs to markdown.@problems→ pass workspace warnings/errors.@file→ add file contents.@folder→ add a whole folder's contents.@terminal→ reference active terminal contents.@git→ include git commits and working changes.
Smart Context Management:
- Context Window Progress: Visual indicator showing token usage and cost impact
- File Context Tracking: Automatic metadata tracking for optimized context
- Sliding Window Management: Maintains context beyond 200k tokens for long tasks
🎯 Plan/Act Mode Toggle
Switch between planning and execution modes:
- Plan Mode: Brainstorm and architect solutions with Valor IDE before implementation
- Act Mode: Execute the planned solution with full tool access
- Mermaid Diagrams: Visual representations of architecture and workflows in Plan mode
- Model Switching: Use different models for planning vs. execution
⏪ Checkpoints: Compare & Restore
- Snapshots your workspace at each task step.
- Compare differences and restore versions safely.
- Explore multiple approaches without losing progress.
- Visual Indicators: Clear checkpoint markers in the chat interface
- Branch-per-Task: Optimized storage with git-based checkpoint system
Advanced Features
🔧 Developer Tools
- Tree-Sitter AST Parsing: Deep code analysis for better understanding
- Advanced Search: Regex-based file search across your entire project
- File Content Optimization: Smart handling of large files and binary detection
- Output Filtering: Configurable output processing for cleaner results
⚙️ Configuration & Customization
.valoriderules: Project-specific custom instructions and rules.valorideignore: Exclude files and patterns from Valor IDE access- Multiple Rule Files: Support for
.valoriderules/directory with multiple configuration files - Advanced Settings: Extended thinking budgets, reasoning effort controls, and model-specific options
🚀 Enhanced UI/UX
- Drag & Drop: Add files and folders directly to chat
- Favorite Models: Quick access to your preferred models
- Advanced Auto-Approval: Granular control over which operations require approval
- Rich Markdown: Full support for code blocks, diagrams, and formatted content
- Task History Search: Fuzzy search and filtering of previous tasks
Contributing
- Start with our Contributing Guide.
- Join the Discord →
#contributorschannel. - Check open positions on our Careers Page.
Local Development
# Clone the repo (requires git-lfs)
git clone https://github.com/valkyrlabs/valoride.git
# Open in VS Code
code valoride
# Install dependencies
npm run install:all
# Launch extension (F5 or Run → Start Debugging)
⚠️ You may need esbuild problem matchers if build issues occur.
Creating a Pull Request
# Create a changeset entry
npm run changeset
Follow prompts for type (major, minor, patch) and description.
Commit both your changes + .changeset file.
Push → Open PR → CI runs → Changesetbot handles versioning + release.