Getting Started with Lumos

Welcome to Lumos — the project management tool built for engineering teams that ship fast and hate overhead.

This guide will get you from zero to productive in under 10 minutes.

Step 1: Create Your Workspace

Your workspace is where your team's issues, roadmaps, cycles, and integrations live. One workspace per company is the most common setup.

# Via CLI (optional)
npm install -g @lumos/cli
lumos auth login
lumos workspace create my-team

Or head to app.lumos.dev and click Create workspace from the onboarding screen.

Step 2: Invite Your Team

Go to Settings → Members → Invite and add your teammates by email. You can set roles:

• Admin — full access including billing and integrations
• Member — can create, update, and close issues
• Viewer — read-only access, useful for stakeholders

Step 3: Connect GitHub

This is where Lumos gets powerful. Link your repos and issues stay automatically in sync with your PRs.

Settings → Integrations → GitHub → Connect

Once connected:

• Branch names like lumos-123-fix-login auto-link to Issue #123
• Opening a PR moves the issue to In Review
• Merging closes it automatically

Step 4: Create Your First Project

Projects in Lumos group related issues under a shared goal. Think "Mobile App Redesign" or "API v2 Migration."

1. Click + New Project in the sidebar
2. Give it a name and an optional description
3. Set a target date (optional but useful for roadmap views)

Step 5: Start a Cycle

Cycles are Lumos's version of sprints — but without the ceremony. Pull in a set of issues, run the cycle for 1–2 weeks, and review what shipped at the end.

1. Open your project → click Cycles
2. Click New cycle → set dates
3. Drag issues in, or let Lumos AI suggest a balanced set

Step 6: Enable AI Triage

Lumos AI reads incoming issues and labels, prioritises, and routes them automatically.

Settings → AI → Enable triage

Configure your routing rules — e.g., "If issue mentions 'auth', assign to the platform team." Takes 5 minutes to set up, saves hours per week.

You're Ready

From here, explore:

• Roadmaps — share progress with stakeholders without meetings
• Insights — see velocity trends and cycle completion rates
• Automations — set up custom workflows without writing code

Got questions? Reach out at support@lumos.dev or join our community Slack.