Installation Guide

Connect Claude Code to Alvsys and supercharge your development workflow with AI-powered issue management

Quick Start

Get up and running in 3 steps:

Install Claude Code from Anthropic
Create a Alvsys project and get your API key
Connect Claude to Alvsys using the MCP command below

1. Install Claude Code

First, you'll need to install Claude Code from Anthropic. This is your AI coding assistant that will work with Alvsys.

Note: Claude Code requires a Claude Pro subscription and is currently available for macOS and VS Code.

Install Claude Code

2. Set Up Your Project

Option A: Create New Project

Start fresh with a new Alvsys project:

Sign up at www.alvsys.com
Click "Create New Project" on your dashboard
Give your project a name and description
Your project ID will be automatically generated

Option B: Import from GitHub

Connect an existing GitHub repository:

Go to your Alvsys dashboard
Click "Import from GitHub"
Authorize the GitHub integration
Select your repository
Your issues will be automatically imported

3. GitHub Actions (Optional)

Set up GitHub Actions to automatically sync your repository with Alvsys:

Benefits of GitHub Actions:

• Automatic issue synchronization
• Real-time status updates
• Seamless PR integration
• Automated project management

Learn more about GitHub Actions setup

4. Get Your Credentials

Find Your Project ID

You'll need your Project ID to connect Claude Code to Alvsys:

Go to Account Settings
Click on the "Projects" tab
Find your project and copy the Project ID

Generate API Token

Create a secure API token for authentication:

Go to Account Settings
Click on the "API Keys" tab
Click "Generate New Key"
Give it a descriptive name (e.g., "Claude Code")
Copy and securely store the generated token

Important: Store your API token securely. You won't be able to see it again after creation.

5. Connect Claude Code to Alvsys

Use the Model Context Protocol (MCP) to connect Claude Code to your Alvsys project:

Installation Command

Replace YOUR_PROJECT_ID and YOUR_API_KEY with your actual values:

claude mcp add --transport http alvsys https://www.alvsys.com/api/llm/mcp --header "X-Project-Id: YOUR_PROJECT_ID" --header "Authorization: Bearer YOUR_API_KEY"

Environment Variable (Optional)

Set this environment variable to avoid passing project IDs manually:

export VIBE_HERO_PROJECT_ID=YOUR_PROJECT_ID

6. Example Commands

Once connected, try these commands with Claude Code:

List Issues

Get an overview of all issues in your project:

show me all the issues in the project

Work on a Specific Issue

Have Claude work on an issue by description keyword:

work on the "description" issue

Check Blocked Issues

Identify issues that might be blocking progress:

are any issues blocked?

Find Human-Only Tasks

Get the next task that requires human intervention:

what's the next human only task?

7. Dev Mode - Full Automation

Ultra-Powered Development

Dev Mode enables full automation where Claude continuously works through your issue board without stopping for summaries or analysis.

What is Dev Mode?

Dev Mode is Alvsys's most powerful feature - it puts Claude Code into a continuous work loop where it:

Automatically pulls the next available task from your board
Works on implementing the solution
Commits and pushes changes
Updates issue status
Immediately moves to the next task
Continues this loop indefinitely until you stop it

Perfect for letting Claude work through your backlog while you sleep!

Enter Dev Mode

Use this command to enter full automation mode:

enter dev_mode and follow instructions. do not stop to provide summary/analysis at ANY point

Pro Tip: Dev Mode works best with well-defined issues. Make sure your issue descriptions are clear and actionable for optimal results.

You're All Set!

Claude Code is now connected to your Alvsys project. Start by trying one of the example commands above, or dive straight into Dev Mode for full automation!

View Your Projects Manage Account Settings