Integrations

An integration is a connection between your organization and a provider, either GitHub or Linear. Integrations are what let CodeLantern skills work with your real project data: reading and writing issues, opening and updating pull requests, and touching your source. You set them up once, in the portal, and every member of your organization works through them.

CodeLantern draws a line between two jobs a provider can do:

• Project manager (PM) is where your work items live: issues, backlog, and the board you plan against.
• Source control (SCM) is where your code lives: branches, commits, and pull requests.

GitHub can do both. Linear does PM only.

Connect GitHub (required)

GitHub is required. It's how skills read and write your issues and pull requests, and, because source control is always GitHub, how they work with your code. Without it, the workflow has nowhere to run.

GitHub connects through the CodeLantern GitHub App. Installing the app grants CodeLantern scoped access to the repositories you choose, so skills can act on your behalf without you handing over personal credentials.

Once GitHub is connected, it can serve as both your project manager and your source control. This is the simplest setup, and a good default if all your work already lives in GitHub Issues and pull requests.

Connect Linear (optional)

If your team plans and tracks work in Linear, connect it as your project manager. Linear connects via OAuth: you authorize CodeLantern from the portal, and the connection is scoped to your Linear workspace.

Linear is PM-only. Your issues and planning live in Linear, but source control stays on GitHub, so a Linear setup always keeps GitHub connected too. Skills read and write your Linear issues while opening and updating pull requests in GitHub.

Next steps