Quick Start

Get up and running with Operum in just a few minutes. This guide will walk you through creating your first team and starting your AI agents.

Step 1: Launch Operum

After installing Operum, launch the application.

Step 2: Install Dependencies

On first launch, Operum checks for required tools:

  • Git - For repository operations
  • GitHub CLI (gh) - For GitHub integration
  • Claude Code - Powers the AI agents

Click the install button for each missing dependency. On macOS/Windows, installation is automatic. On Linux, copy the displayed commands to your terminal.

Login screen with dependency status

Step 3: Sign In

Click "Login with Operum" to authenticate:

  1. Your browser will open to the Operum login page
  2. Sign in with your email or OAuth provider
  3. You'll be redirected back to the desktop app
Tip: Start your free 7-day trial to access all features. Join our Discord for support.

Step 4: Create Your First Team

A team is a collection of AI agents working together on a project. To create one:

  1. Click "Create Team" in the sidebar
  2. Enter a name for your team (e.g., "My SaaS Project")
  3. Select a working directory - this is where agent files will be stored
  4. Click "Create"

Step 5: Connect GitHub (Optional)

For agents to interact with your code, connect a GitHub repository:

  1. Open your team settings
  2. Click "Connect GitHub"
  3. Enter your repository URL (e.g., https://github.com/user/repo)
  4. Make sure GitHub CLI (gh) is authenticated

Step 6: Start an Agent

Now you're ready to start an agent:

  1. Select your team from the sidebar
  2. You'll see the available agents (PM, Architect, Engineer, etc.)
  3. Click "Start" on any agent to launch it
  4. The agent will open in a new terminal with Claude Code
Agents page showing all 6 agents
Tip: Start with the PM Agent - it coordinates the other agents and can help you plan tasks.

Step 7: Give Your First Task

With an agent running, you can start giving it tasks. In the agent's terminal:

Can you review the current state of the project and suggest priorities for this week?

The agent will analyze your repository (if connected) and provide recommendations based on its role.

What's Next?

Feedback: Your feedback is valuable! Report issues on GitHub or in our Discord.