All notable changes to this project will be documented in this file.
-
Linear Integration: Added comprehensive Linear support for accessing issues directly from the command line with rich formatting and full context.
- Commands:
vibe-tools linear connect- Interactive authentication setup supporting both personal API keys and OAuth2 PKCE flowvibe-tools linear get-issue <identifier>- Display detailed Linear issue informationvibe-tools linear issue <identifier>- Alternative command name for issue retrieval
- Authentication Methods:
- Personal API Key: Simple setup with guided browser navigation to Linear settings
- OAuth2 with PKCE: Secure browser-based authentication with automatic token management
- Environment variable support:
LINEAR_API_KEYin.vibe-tools.envfiles
- Issue Details: Complete issue information including title, description, status, priority, assignee, creator, timestamps
- Comments & Discussion: Full discussion thread with timestamps and author information
- Attachments: List of attached files with direct links
- Flexible Identifiers: Support for both Linear identifiers (e.g.,
ITE-123) and UUID format
- Commands:
-
GitHub Command Improvements: Added GitHub command parameters (
--review-only,--discussion-only,--metadata-only,--no-links,--hide-resolved).
- Groq Provider Support: Added support for the Groq provider, enabling access to fast inference models including
moonshotai/kimi-k2-instructandqwen/qwen3-32b. Configure using theGROQ_API_KEYenvironment variable.- Available across all commands that support provider selection (ask, web, repo, doc, plan)
- Optimized for high-speed inference with competitive performance
- Includes comprehensive error handling and model validation
- Automatic Doppler Secrets Integration: vibe-tools now automatically detects a Doppler-configured project and, when the
dopplerCLI is on the PATH, loads any secrets that end with_API_KEYinto the environment before commands execute. This means you no longer need to copy provider API keys into.envfiles for projects that already manage secrets with Doppler. The feature is enabled by default and can be disabled by adding"disableDoppler": trueto yourvibe-tools.config.json. - Local File Support for
--with-doc: You can now pass local files directly to the--with-docflag (relative/absolute paths orfile://URLs) across theask,repo,plan, anddoccommands. This makes it simple to enrich prompts with Markdown, text, or other documents from your filesystem without hosting them online. - XAI (Grok) Web Search & Reasoning Effort: Grok models now support the
--webflag for live web search with source citations and the--reasoning-effortflag (low,medium,high) for deeper analysis. Works acrossask,web,repo,doc, andplancommands, bringing Grok feature-parity with Gemini and Perplexity providers.
- Smarter Installation Process: Enhanced the
vibe-tools installcommand with intelligent configuration and rules file management.- When existing configuration is found, users are now offered a clear choice: keep the current setup or update it through interactive prompts
- Installation no longer overwrites IDE rules files that are already up to date or newer than the current version
- Added semantic version comparison to prevent unnecessary rules file updates
- Improved user experience with clearer messaging about what's being updated and why
-
Increased Default Max Tokens: Raised the default maximum output tokens from 8,000 to 24,000 across all commands for more comprehensive responses.
- All commands now generate longer, more detailed outputs by default
- Anthropic provider automatically uses streaming API for requests above 21,000 tokens
- Users can still override with the
--max-tokensflag for specific needs - Tested and verified compatibility across all major providers (Perplexity, Gemini, xAI, OpenRouter, Anthropic)
-
Updated Gemini Model Names to Stable Versions: Migrated all Gemini 2.5 model references from preview versions to stable versions throughout the codebase.
gemini-2.5-flash-preview-*→gemini-2.5-flashgemini-2.5-pro-preview*→gemini-2.5-pro- Updated default models in all commands (ask, web, plan, repo, doc, youtube, mcp, test)
- Updated error message suggestions to recommend stable model names
- Updated installation prompts and configuration examples
- Maintained full backward compatibility - preview model names continue to work
-
Updated Default Models to latest versions:
- Gemini: 2.5 production models (no longer preview)
- Anthropic: Claude 4 series
- OpenAI: GPT-4o and o3 series
- New Gemini Flash Lite Preview Model: Added support for
gemini-2.5-flash-lite-preview-06-17as a lightweight option.- Available in installation prompts for coding and web search agents
- Added to model suggestions in error messages for Gemini, OpenRouter, and ModelBox providers
- Not set as default for any command - users must explicitly select it
- Labeled with "lightweight" hint in installation UI
- Non-Interactive Installation Mode: Added comprehensive support for automated installations in CI/CD environments and scripts.
- Automatically detects CI environments via
CI=true,DEBIAN_FRONTEND=noninteractive, orNONINTERACTIVE=trueenvironment variables - Auto-detects package manager (npm, yarn, pnpm, bun) based on installation path and symlinks for seamless auto-updates
- Auto-detects Cursor IDE when
CURSOR_TRACE_IDenvironment variable is present - Prioritizes local configuration over global when both exist
- Skips all interactive prompts and uses intelligent defaults
- Preserves existing configurations and API keys from environment variables
- Enhanced security: skips writing API keys to filesystem in CI environments, using only environment variables
- Automatically detects CI environments via
- Automatic Playwright Browser Installation: Browser commands now automatically install required Playwright browsers (Chromium) during the vibe-tools installation process.
- Uses the programmatic Playwright API to ensure version compatibility with vibe-tools' Playwright dependency
- Installs only Chromium browser to minimize download size and installation time
- Integrated into both interactive (
vibe-tools install) and JSON installation flows - Can be skipped by setting
SKIP_PLAYWRIGHT=1environment variable - Eliminates the need for manual
npx playwright installcommands
- Streamlined CI/CD Integration: Installation process now works seamlessly in automated environments without requiring user interaction.
- Automatic configuration detection and reuse
- Smart defaults based on environment detection
- No prompts for package manager selection, telemetry, or configuration location
- Maintains full functionality while respecting CI security practices
- Enhanced Browser Command Reliability: All browser commands now include comprehensive Playwright availability checks.
- Added
ensurePlaywrightBrowsers()verification to all browser subcommands (open,act,extract,observe) - Enhanced
--with-docimplementations with proper Playwright checks before browser automation - Improved error handling when Playwright or browsers are not available
- Better user experience with automatic browser installation and clear error messages
- Added
- Browser Open Command Timeout: Fixed timeout issue when using
vibe-tools browser open --connect-towith existing Chrome instances.- Commands now complete successfully without hanging when connecting to existing browser sessions
- Browser instances remain open and functional after command completion when using
--connect-to - Improved reliability for browser automation workflows that reuse existing Chrome instances
- Updated release process and documentation
-
Browser Mac-Chrome Lite Mode: Added
--liteflag tovibe-tools browser mac-chromecommand for faster startup and minimal side-effects.- Launches Chrome with only essential debugging flags for quicker initialization
- Reduces automation overhead while maintaining remote debugging capability
- Ideal for lightweight testing scenarios where full automation flags aren't needed
-
Git Diff Integration for Repo Command: Added
--with-diffflag tovibe-tools repocommand for enhanced code review capabilities.- Includes git diff information along with full repository context from repomix
- Keeps AI focus on current scope of changes while maintaining full codebase understanding
- Added
--baseflag to specify different branch for diff comparison - Works with external documentation via
--with-docflag for comprehensive analysis
- Browser Mac Chrome Command: Added
vibe-tools browser mac-chromecommand to start a Chrome instance with remote debugging on macOS.- Only supported on macOS systems - provides clear error message on other platforms
- Launches Chrome with comprehensive debugging flags optimized for automation
- Creates isolated temporary profile for clean testing environment
- Enables remote debugging on port 9222 for Playwright/CDP connections
- Includes extensive Chrome flags from proven automation configurations
- Provides clear instructions for connecting with Playwright after launch
- Enhanced Browser Model Support: Improved Stagehand model handling in browser commands with:
- Added support for additional providers (Gemini, OpenRouter) in browser commands
- Expanded available model options including
claude-3-7-sonnet-latest,o3,o4-mini,gpt-4.1,gpt-4.1-mini,gemini-2.5-flash-preview-04-17, andgroq-llama-3.3-70b-versatile - Better API key handling for different providers (Anthropic, OpenAI, Gemini, OpenRouter)
- Improved model configuration structure with
modelClientOptionsfor better compatibility - Enhanced model name resolution with automatic provider prefix handling
- Better error handling when providers or models are not recognized
- Web Search Flag: Added
--webflag to enable web search capabilities for supported models (currently Gemini models) across all commands.
- Claude 4 Model Updates: Updated all references from Claude 3.7 Sonnet models to Claude 4 models throughout the codebase, including:
- Configuration files and documentation examples
- Default model settings for Anthropic provider in browser commands
- Model references in Stagehand configuration
- Updated default model from
claude-3-7-sonnet-latesttoclaude-sonnet-4-20250514
- Updated all references to the Gemini 2.5 model from 'pro-exp' to 'pro-preview' for consistency.
- Updated configuration files, documentation, error messages, and tests to use the new model name.
- Patched version comparison logic in versionUtils.ts to correctly detect outdated versions.
- Removed a number of dependencies from package.json to speed up installation.
- Wait Command: Added a new `wait` command (`vibe-tools wait `) that pauses execution for the specified number of seconds.
- MCP GitHub Search: The `vibe-tools mcp search` command now automatically includes searching GitHub repositories by default to discover more MCP servers.
- Opt-in Telemetry: Added opt-in telemetry to help improve vibe-tools. More details can be found in `TELEMETRY.md`.
- Official vibe-tools MCP: Announcing the official `vibe-tools-mcp` server, available at `https://github.com/FutureExcited/vibe-tools-mcp\`. This server will house a collection of useful tools for AI agents.
- Repo Command: Now shows top 10 largest files by token count when using
--debugflag and during token limit errors.
- Support multiple
--with-docURLs forask,repo,plan, anddoccommands, allowing users to provide context from several documents simultaneously.
- Fix for auto-update logic under different package managers
- Auto-update:
- Automatically updates vibe-tools CLI to the latest version
- Runs automatically on either of the commands
- Automatically detects available IDEs and updates rules (if vibe-tools Integration detected)
- For vibe-tools install it prompts user if they wanna continue with installation
-
Doc & Browser Commands Provider Improvements:
- Doc and repo commands are now properly using their configured providers.
-
CTA improvement:
- Improved CTA for vibe-tools install to prompt user if they wanna continue with installationto do stuff. Removed misleading mention of --help flag.
- Documented ask --with-doc command
- Document Web Url Integration: Added
--with-doc <doc_url>flag torepoanddoccommands to fetch content from any web URL and include it as context.- Uses the internal browser open command with a wait time to capture rendered HTML.
- Implements retry logic (3s, 5s, 10s waits) for fetching content to improve reliability.
- For repo: Prepends fetched document content to the user query sent to the analysis model.
- For doc: Includes fetched document content as additional context for documentation generation.
- Document Web Url Integration: Added
--with-doc <doc_url>flag torepoanddoccommands to fetch content from any web URL and include it as context.- Uses the internal browser open command with a wait time to capture rendered HTML.
- Implements retry logic (3s, 5s, 10s waits) for fetching content to improve reliability.
- For repo: Prepends fetched document content to the user query sent to the analysis model.
- For doc: Includes fetched document content as additional context for documentation generation.
- Codex Support: Added support for OpenAI Codex instructions similar to Claude code instructions, providing a consistent experience across different AI models.
- Support for both local
codex.mdat repository root and global~/.codex/instructions.md
- Support for both local
- Installation Process:
- Added support for copying existing global config during installation
- Fixed incorrect provider naming bug
- Fixed Gemini 2.5 Pro correct naming
- Added suggestion to delete old cursor-tools folder if it exists
- Enhanced UX for Claude code and Codex instructions setup
- X.AI Provider Support: Added support for the X.AI provider, enabling the use of Grok models (e.g.,
grok-3-latest,grok-3-mini-latest). Configure using theXAI_API_KEYenvironment variable. - Document Web Url Integration: Added
--with-doc <doc_url>flag torepoanddoccommands to fetch content from any web URL and include it as context.
- Updated default Gemini Pro model from 2.0 to gemini-2.5-pro-exp for improved performance
-
Youtube command: Added
youtubecommand that can be used to analyze YouTube videos and generate detailed reports:- Support for multiple analysis types: summaries, transcripts, implementation plans, reviews, or custom analysis
- Optional questions parameter for targeted insights about video content
- Uses Gemini models which have native YouTube video understanding capabilities
- Results can be saved to files for reference and sharing
- Requires
GEMINI_API_KEYto be set in your environment or .vibe-tools.env file
-
Support for Reasoning Effort Parameter: Added
--reasoning-effortparameter to enhance the quality of responses for complex queries:- Supports
low,medium, andhighvalues for controlling reasoning depth - Compatible with OpenAI o1 and o3-mini models directly
- Translated to extended thinking with appropriate token budgets for Claude 3.7 Sonnet models
- Works with OpenRouter provider using a compatible format
- Can be overridden for custom models by setting the
OVERRIDE_SAFETY_CHECKS=trueenvironment variable
- Supports
- Test Reporting Displays Detailed Scenario Results: Fixed an issue in
src/commands/test/command.tswhere test scenario details were not being correctly displayed in generated reports. The fix ensures that the promises returned byqueue.add()are properly handled, allowing detailed scenario information to appear in test reports.
- GitHub Repository Analysis for Repo Command: Added
--from-githubparameter to the repo command, enabling analysis of remote GitHub repositories without local cloning. This feature provides the same functionality previously available in the doc command, making it easier to get context-aware assistance for any public GitHub repository (e.g.,vibe-tools repo "explain the authentication flow" --from-github=username/repo-name).
-
Support for Custom Repomix Configuration: Added support for
repomix.config.jsonfiles to customize which files are included/excluded during repository analysis. This configuration file can be placed in the repository root and will be automatically detected byrepo,plan, anddoccommands, allowing for more precise control over repository content analysis. -
Subdirectory Analysis for Repo Command: Added
--subdirparameter to the repo command, allowing users to analyze a specific subdirectory instead of the entire repository. This makes the repo command more efficient when working with large codebases by focusing only on relevant subdirectories (e.g.,vibe-tools repo "explain the code" --subdir=src/commands). -
Improved Model Name Resolution: Enhanced model name handling across providers to better handle experimental and latest model versions:
- Automatically resolves
-exp-*suffixes to find stable model versions - Resolves
-latestsuffixes to the most recent compatible model - For ModelBox and OpenRouter: automatically finds models across providers without requiring provider prefixes (e.g.
gpt-4owill findopenai/gpt-4o) - Provides helpful suggestions when models aren't found, showing similar available models
- Automatically resolves
-
Support for OpenRouter when using MCP
-
By default the
mcpcommand uses Anthropic, but now takes a --provider argument that can be set to 'anthropic' or 'openrouter' -
MCP commands require
ANTHROPIC_API_KEYorOPENROUTER_API_KEYto be set in your environment -
The '--model' arg can also be used with the MCP command to set the OpenRouter model. It is ignored if the provider is Anthropic.
-
Google Vertex AI Authentication: Added support for Google Vertex AI authentication using JSON key files or Application Default Credentials (ADC). This update maintains backward compatibility, continuing to support the direct API key string method, while adding additional authentication options. To use this feature, set the
GEMINI_API_KEYenvironment variable to the path of your JSON key file or toadcto use Application Default Credentials. This enables access to gemini models such asgemini-2.0-flashvia the Vertex AI. This feature introduces a new dependency:google-auth-library.- Example: Using Service Account JSON Key
Set
GEMINI_API_KEYto the path of your service account JSON key file:GEMINI_API_KEY="./path/to/service-account.json"
- Example: Using Application Default Credentials (ADC)
First, authenticate locally using gcloud:
Then set
gcloud auth application-default login
GEMINI_API_KEYtoadcto use Application Default Credentials:GEMINI_API_KEY="adc"
- Example: Using Service Account JSON Key
Set
-
New Test Command: Added comprehensive test command for automated feature behavior testing:
- Real Command Execution: Tests now execute actual vibe-tools commands in a controlled environment, validating real-world behavior instead of simulated outputs.
- Parallel test execution with dynamic worker allocation for faster test suite runtime.
- Scenario-specific output buffering for clean parallel execution logs, ensuring readability even with concurrent tests.
- Progress tracking showing completed/running/pending scenarios, providing real-time feedback during test runs.
- Execution time statistics including total execution time and time saved by parallelization, offering insights into performance gains.
- Detailed test reports with:
- Test scenario details and results, including clear PASS/FAIL status with visual markers.
- Tool execution logs: Detailed record of each tool execution during tests, including arguments, outputs (stdout/stderr), and any errors, providing in-depth insight into test execution flow.
- Approach summaries using Gemini: After each test scenario, Gemini is used to summarize the AI agent's approach, providing a natural language overview of the steps and tools used to solve the test scenario.
- Test coverage includes various categories of scenarios: Happy Path, Error Handling, Edge Cases, and Performance.
- Support for test asset management and references: Introduced a robust system for managing test assets, allowing scenarios to reference external files or inline content, improving test data organization and reusability.
- Intelligent retry mechanism with exponential backoff: Implemented a retry system that automatically handles transient errors with exponential backoff and jitter, improving test reliability and reducing false negatives.
- Enhanced error handling and reporting: Improved error messages now include detailed information such as error types, stack traces, and context, making debugging test failures more efficient.
-
Improved ModelBox Provider: Enhanced the ModelBox provider with improved model name handling. If a requested model is not found, vibe-tools now provides helpful suggestions for similar models. Error messages have also been clarified to better guide users on the requirement for provider prefixes when specifying ModelBox models.
-
Example: Improved Error Message If you use an invalid model with ModelBox, you will now receive suggestions:
Error: Model 'invalid-model' not found in ModelBox. You requested: invalid-model Similar available models: - openai/gpt-4o - anthropic/claude-3-5-sonnet Use --model with one of the above models. Note: ModelBox requires provider prefixes (e.g., 'openai/gpt-4' instead of just 'gpt-4').
-
-
Added support for MCP server overrides in the marketplace
- Implemented hardcoded overrides in
MCP_OVERRIDESmap - Added override for google-calendar-mcp to use eastlondoner fork
- Overrides can specify custom
githubUrl,command, andargs - Preserves environment variables when using overrides
- Type-safe implementation ensures overrides match the MCPServer interface
- Overrides take precedence over marketplace data and automatic GitHub repository checks
- Logs when an override is applied using console.log for transparency
- Added support for user-configurable overrides in
vibe-tools.config.json- Users can define custom overrides in the
mcp.overridessection - Config overrides take precedence over hardcoded overrides
- Warns when a config override replaces a hardcoded override
- Users can define custom overrides in the
- Implemented hardcoded overrides in
- Updated all references to Claude 3.5 Sonnet models to Claude 3.7 Sonnet models throughout the codebase
- Updated model references in configuration files, documentation, and source code
- Updated default model settings for Anthropic provider
- Updated error messages and model suggestions
- Used
claude-3-7-sonnetfor most use cases andclaude-3-7-sonnet-thinkingfor MCP client
- Updated @browserbasehq/stagehand dependency from 1.13.0 to 1.13.1
- Updated @browserbasehq/stagehand dependency from 1.13.1 to 1.14.0
- Added new dependencies for test command:
- Added
p-queuefor parallel execution management - Added
globand@types/globfor test file pattern matching - Added
playwrightandplaywright-corewith version pinning
- Added
- vibe-tools now only recommends global installation
- Updated install command to check for and warn about vibe-tools dependencies in package.json files
- Checks both dependencies and devDependencies in package.json
- Provides clear instructions for removing local installations using npm, pnpm, or yarn
- This is in response to multiple issues caused by local installation and execution under different js runtimes
- Added validation to require --tag alpha or --tag latest when running release command
- Added ModelBox provider for access to a wider range of models through an OpenAI-compatible API
- Added OpenRouter provider to enable access to models from various providers including Perplexity
- New ClickUp integration command for task management
- Added ClickUp authentication flow with API token request during installation
- Implemented ClickUp command with task management capabilities
- Added ClickUp command instructions to template
- Added instructions for Chrome remote debugging setup in cursor rules
- Improved browser command state management when using
--connect-to:- Reuses existing browser tabs for subsequent commands in a session, preserving page state
- Introduced
reload-currentas a special URL value to refresh the current page without losing the connected session
- Browser commands (
open,act,observe,extract) now have--consoleand--networkoptions enabled by default. Use--no-consoleand--no-networkto disable them. - Improved page reuse in browser commands when using
--connect-to: now reuses existing tabs instead of creating new ones for better state preservation - Improved error handling and type safety in cursor rules management
- Enhanced directory creation order in installation process
- Added user choice during installation for cursor rules location (legacy
.cursorrulesor new.cursor/rules/vibe-tools.mdc) - Added
USE_LEGACY_CURSORRULESenvironment variable to control cursor rules file location - Improved output handling across all commands:
- Centralized output handling in main CLI
- Commands now yield output consistently
- Better error handling for file writes
- Added timeout protection for stdout writes
- More reliable output flushing
- Improved security by not logging API keys in stagehand config
- Fixed debug logging in all provider commands to properly pass through the debug flag
- Fixed
askcommand to pass debug flag to provider - Fixed
webcommand to properly handle debug flag - Fixed
doccommand to include debug flag in options - Fixed
plancommand to pass debug flag to both file and thinking providers - Standardized debug logging format across all providers
- Debug logs now show full request and response details when enabled
- Fixed
- Changed default thinking provider for plan command to OpenAI with o3-mini model for significantly faster plan generation, while maintaining plan quality
- New
askcommand for direct model queries- Requires both provider and model parameters
- Allows querying any model from any provider directly
- Simple and focused command for direct questions
- Support for new Cursor IDE project rules structure
- New installations now use
.cursor/rules/vibe-tools.mdcby default - Maintain compatibility with legacy
.cursorrulesfile viaUSE_LEGACY_CURSORRULES=true - Interactive choice during installation
- When both exist, use path based on
USE_LEGACY_CURSORRULESenvironment variable - Updated documentation to reflect new path structure
- New installations now use
- Added support for the
gpt-4omodel in browser commands (act,extract,observe)- The model can be selected using the
--model=gpt-4ocommand-line option - The default model can be configured in
vibe-tools.config.json - If no model is specified, a default model is used based on the configured provider (OpenAI or Anthropic)
- The model can be selected using the
- Internal: Bundled Stagehand script directly into the codebase to prevent dependency issues
- Build: Added stagehand script verification to the release process
- Enhanced
plancommand with dual-provider architecture:- Separate providers for file identification and plan generation
fileProviderhandles repository file analysisthinkingProvidergenerates implementation plans- New command options:
--fileProvider: Provider for file identification (gemini, openai, or openrouter)--thinkingProvider: Provider for plan generation (gemini, openai, or openrouter)--fileModel: Model to use for file identification--thinkingModel: Model to use for plan generation--fileMaxTokens: Maximum tokens for file identification--thinkingMaxTokens: Maximum tokens for plan generation
- Brand new provider system with enhanced error handling and configuration:
- New provider interfaces for specialized tasks
- Shared implementations via provider mixins
- Better error messages and debugging support
- Configurable system prompts for different tasks
- Added
--quietflag to suppress stdout output while still saving to file with--save-to- Useful for scripting and automated documentation generation
- All commands now support quiet mode
- Error messages are still displayed even in quiet mode
- Fixed browser commands to respect system color scheme when using
--connect-toby not forcing a specific color scheme
- Fixed browser commands to not set viewport size in Stagehand when using
--connect-to
- Fixed browser commands to not set viewport size when using
--connect-towithout an explicit--viewportoption
- Browser commands (
open,act,observe,extract) now have--consoleand--networkoptions enabled by default. Use--no-consoleand--no-networkto disable them.
- Fixed browser commands to always reuse existing tabs when using
--connect-toinstead of creating new ones
- Browser commands now preserve viewport size when using
--connect-tounless--viewportis explicitly provided - Added validation to prevent using
--videowith--connect-toas video recording is not supported when connecting to existing Chrome instances
- Added
reload-currentas a special URL value for browser commands when using--connect-to. This allows refreshing the current page while maintaining the connection, which is particularly useful in development workflows.
- Fixed console logging in browser act command by correcting parameter order in outputMessages call
- Browser commands now support
--url=currentto skip navigation and use the current page - Browser commands now automatically skip navigation if already on the correct URL
- Improved page reuse when connecting to existing Chrome instance
- New
browsercommand for AI-powered web automation and debugging, leveraging Stagehand AI for natural language interactionact <instruction> --url <url> [options]: Execute actions on a webpage using natural language instructions<instruction>: Natural language instruction describing the action (e.g., "Click Login", "Type 'hello' in the search box")--url <url>: Required URL to navigate to before performing actions- Additional options:
--delay=<milliseconds>: Delay between actions (default: 100)--retry=<number>: Number of retries for failed actions (default: 3)
extract <instruction> --url <url> [options]: Extract data from webpages based on natural language instructions<instruction>: Natural language instruction describing the data to extract (e.g., "product names", "article content")--url <url>: Required URL to navigate to- Additional options:
--format=<json|csv|text>: Output format (default: json)--flatten: Flatten nested objects in output
observe <instruction> --url <url> [options]: Observe interactive elements on a webpage and suggest possible actions<instruction>: Natural language instruction describing what to observe (e.g., "interactive elements", "login form")--url <url>: Required URL to navigate to- Additional options:
--interval=<milliseconds>: Check interval for observation (default: 1000)--duration=<duration>: Total observation time (e.g., '30s', '5m')--changes-only: Only report when changes are detected
open <url> [options]: Open and interact with web pages- Capture HTML content with
--html - Monitor console logs with
--console - Track network activity with
--network - Take screenshots with
--screenshot=<file path> - Configure viewport size with
--viewport=<width>x<height> - Debug with visible browser using
--no-headless - Connect to existing Chrome instances with
--connect-to=<port>
- Capture HTML content with
- Common options for all browser commands:
--timeout=<milliseconds>: Set navigation timeout (default: 30000)--viewport=<width>x<height>: Set viewport size (e.g., 1280x720)--headless: Run browser in headless mode (default: true)--no-headless: Show browser UI for visual inspection and debugging--connect-to=<port>: Connect to an existing Chrome instance--wait=<duration or selector>: Wait after page load, supports:- Time duration: '5s', '1000ms', '2m' (seconds, milliseconds, minutes)
- CSS selector: '#element-id', '.my-class'
- Explicit format: 'time:5s', 'selector:#element-id', 'css:.my-class'
- Made Playwright a peer dependency for lighter installation
- Added browser configuration options in config file (headless mode, viewport, timeout)
- Integrated Stagehand AI for browser automation
- Support for OpenAI and Anthropic providers
- Auto-selection of provider based on available API keys
- Configurable timeout and debug options
- Moved Playwright from direct dependency to peer dependency
- Users need to install Playwright separately to use browser commands
- Added clear installation instructions and error messages
- Fixed punycode deprecation warning by properly redirecting both
punycodeandnode:punycodeimports topunycode/
- Fixed dynamic require issues with Node.js built-in modules by using proper ESM imports
- Improved handling of Node.js built-in modules in build configuration
- Changed default tokenizer to
o200k_basefor better compatibility with Gemini models - Added configurable tokenizer support through
tokenCount.encodingin config file - Updated documentation to reflect new tokenizer configuration options
- Big improvements to robustness of command line arguments
- Introduces doc command to generate documentation for local or remote repositories
- Introduces github command to access PRs and issues from github
- Support for listing recent PRs and issues
- Detailed view of PR/issue discussions and code review comments
- Multiple authentication methods:
- GitHub token via environment variable
- GitHub CLI integration for automatic token generation
- Git credentials support (stored tokens or Basic Auth)
- Support for both local and remote repositories
- Markdown-formatted output for readability
- Use token count estimation to switch gemini models to pro if repository is large to fit any other model
- Updates GitHub model names to latest versions
- Updates Perplexity model names to latest versions
- Added version command to display the current version of vibe-tools
- Improved GitHub authentication error handling and rate limit messages
- Better detection of stored GitHub tokens in git credentials
- Fixed authentication status messages to accurately reflect available methods
- Fixed ESM compatibility issues with Node.js built-in modules
- Removed bundling of Node.js built-ins for better ESM support
- Reduced bundle size by externalizing Node.js core modules
- Fixed dynamic require issues with Node.js built-in modules
- Updated build configuration to properly handle Node.js built-ins in ESM context
- Fixed dynamic require of url module in ESM context
- Updated import-meta-url.js to use proper ESM imports
- Improved release process with dedicated release script
- Fixed ESM compatibility issues with dependencies
- Added better error handling for git operations during release
- Updated build configuration to output ES Module format for better Node.js 20+ compatibility
- Changed output file from CommonJS (.cjs) to ES Module (.mjs)
- Fixed ESM compatibility issues with dependencies
- Added branch support for GitHub repositories in
doccommand- Support for specifying branch using
@branchsyntax (e.g.--fromGithub=username/repo@branch) - Works with both HTTPS URLs and shorthand format
- Properly integrates with repomix API using the
refparameter
- Support for specifying branch using
- New
doccommand to generate comprehensive repository documentation- Support for local repository documentation generation
- Support for remote GitHub repository documentation via
--fromGithuboption - Option to save documentation to file with
--output
- Development mode support via
pnpm devfor running latest code without building
- Updated
.cursorrulesto include documentation for the newdoccommand - Improved command-line argument parsing for better option handling
Initial release with basic functionality:
- Web search using Perplexity AI
- Repository context-aware answers using Google Gemini
- Installation and configuration utilities
- Document Web Url Integration: Added
--with-doc <doc_url>flag torepoanddoccommands to fetch content from any web URL and include it as context. - YouTube Video Analysis: Added
youtubecommand for analyzing YouTube videos (summaries, transcripts, etc.).