Via Plugin Marketplace for Claude Code
Official plugin marketplace for Via - bringing intelligent codebase indexing and search to Claude Code.
🚀 Quick Start
Installation
-
Start Claude Code in your project directory:
cd your-project
claude
-
Add Via marketplace using the /plugin command:
/plugin
-
Select "Add marketplace" and enter:
https://github.com/via-ai-inc/via-cc-plugin-marketplace
-
Install the Via plugin from the marketplace
-
Test the installation:
/via-cc-plugin:hello
📦 Available Plugins
Via CC Plugin
Intelligent codebase indexing and semantic search for Claude Code.
Commands:
/via-cc-plugin:hello - Test plugin connectivity/via-cc-plugin:index [path] - Index your codebase
📖 Usage
Index Your Codebase
Index current directory:
/via-cc-plugin:index
Index specific directory:
/via-cc-plugin:index ~/path/to/project
Requirements:
ANTHROPIC_API_KEY environment variable set to your Via virtual key- Internet connection
What Gets Indexed?
The plugin creates a tarball of your current directory, excluding:
.git and version control filesnode_modules, vendor, dependency folders- Build artifacts (
dist, build, target, out)
- Virtual environments (
venv, .venv, env)
- IDE configurations (
.idea, .vscode, .vs)
- Compiled files (
*.pyc, *.pyo, __pycache__)
- Large media files (
*.mp4, *.mov, *.zip, *.tar.gz)
- Environment files (
.env, .env.local)
Indexing Process
- Upload: Creates tarball and uploads to Via-LiteLLM service
- Extract: Server extracts files to temporary location
- Index: Codemap2 generates searchable database (async, 30-120s)
- Search: Use natural language queries to find code
Example Queries
Once indexed, ask Claude Code:
"Search for the QuantityIterator class using codemap_search"
"Find all functions that handle HTTP requests"
"Show me where database models are defined"
"Use codemap_search to find authentication logic"
🔑 Getting API Keys
Contact your Via administrator for your Via virtual API key. This key should be set as the ANTHROPIC_API_KEY environment variable:
export ANTHROPIC_API_KEY="sk-your-via-virtual-key"
Add this to your ~/.zshrc or ~/.bashrc to persist across sessions.
🏗️ Architecture
Claude Code
↓
Via Plugin (this repo)
↓
Via-LiteLLM Service (proxy + orchestration)
↓
Codemap2 Service (indexing + search)
↓
Search Results → Claude Code conversation
🛠️ Development
Repository Structure
.claude-plugin/
marketplace.json # Marketplace metadata
via-cc-plugin/
.claude-plugin/
plugin.json # Plugin metadata
commands/
hello.md # Hello command prompt
index.md # Index command prompt
index-repository.sh # Indexing script
Local Testing
To test the plugin locally without publishing:
cd /path/to/via-cc-plugin-marketplace
claude
# Inside Claude Code session
/plugin
# Select "Add marketplace"
# Enter: /path/to/via-cc-plugin-marketplace
📋 Requirements
- Claude Code CLI (version with plugin support)
- Bash shell (for indexing script)
- curl (auto-installed if missing)
- bc (basic calculator, auto-installed if missing)
🔧 Troubleshooting
Plugin not found
- Verify you entered the correct marketplace URL
- Check network connectivity
- Try removing and re-adding the marketplace
Upload fails
# Test service endpoint
curl https://via-litellm-dev-647509527972.us-west1.run.app/health/liveliness
# Verify API key is set
echo $ANTHROPIC_API_KEY | grep "sk-"
Tarball too small
- Check if directory contains code files
- Verify you're not in an empty directory
- Run:
ls -lah to see directory contents
🤝 Contributing
We welcome contributions! To add new commands or improve existing ones:
- Fork this repository
- Create a feature branch
- Add your command as a
.md file in via-cc-plugin/commands/
- Update
plugin.json if needed
- Submit a pull request
📄 License
[License TBD]
🔗 Links
💬 Support
For issues or questions:
- Open an issue in this repository
- Contact: support@via.dev (TBD)
- Join our Discord: [link TBD]
Made with ❤️ by Via Inc
wshobson
Lucklyric
xrf9268-hue
anthropics
uppinote20