linear-and-github-extension

Frequently Asked Questions (FAQ)

Common questions about Linear And GitHub Extension (LAGE).

Table of Contents

General

What is LAGE?

LAGE (Linear And GitHub Extension) is a free, open-source Chrome browser extension that integrates Linear issue tracking with GitHub. It displays Linear issue details directly on GitHub pull request and compare pages, making it easier to see the connection between your code changes and Linear issues.

Is LAGE free?

Yes! LAGE is completely free and open-source under the MIT license. There are no paid features, subscriptions, or hidden costs.

Who maintains LAGE?

LAGE is maintained by @nelsondaza and community contributors. It’s an open-source project welcoming contributions from everyone.

How is LAGE different from Linear’s GitHub integration?

LAGE is a browser extension that enhances your GitHub browsing experience locally, while Linear’s official GitHub integration is a server-side integration that syncs data between the two platforms. They can be used together!

LAGE adds:

Linear’s integration provides:

What browsers are supported?

Currently:

See our roadmap for future browser support.

Installation & Setup

How do I install LAGE?

From Chrome Web Store (coming soon):

  1. Visit Chrome Web Store
  2. Click “Add to Chrome”

Manual installation:

  1. Download from GitHub Releases
  2. Extract ZIP and load as unpacked extension (chrome://extensions/)

For troubleshooting installation issues, see TROUBLESHOOTING.md.

Do I need a Linear account?

Yes, you need a Linear account to use LAGE. Linear offers a free plan!

Do I need a paid Linear subscription?

No! LAGE works with free Linear accounts. API keys are available on all Linear plans.

How do I get a Linear API key?

See our detailed Linear API Key Setup Guide for complete instructions.

Can I use LAGE without a GitHub account?

You don’t need to be logged into GitHub, but LAGE only works on GitHub pages. If you’re viewing GitHub, it will work whether you’re logged in or not.

Does LAGE work with GitHub Enterprise?

Not yet. LAGE currently only supports github.com. Enterprise support is on our roadmap.

Features & Functionality

What GitHub pages does LAGE work on?

LAGE works on:

LAGE does NOT work on:

What Linear issue information does LAGE display?

LAGE shows:

How does LAGE detect Linear issues?

LAGE scans PR titles, descriptions, and commit messages for Linear issue codes in the format [A-Z0-9]{1,7}-\d+ (e.g., PROJ-123).

For troubleshooting detection issues, see TROUBLESHOOTING.md.

Can LAGE detect issues in comments?

No, LAGE currently only scans PR titles, descriptions, and commit messages. Issue codes in comments are not detected.

Can I create or update Linear issues from GitHub?

No, LAGE is read-only. It only displays issue information. You need to go to Linear to create or update issues.

For write operations, consider using Linear’s official GitHub integration.

Does LAGE work offline?

No, LAGE requires an internet connection to fetch data from Linear’s API.

Does LAGE cache data?

Yes, LAGE caches API responses to improve performance and reduce API calls. Cache duration varies by data type.

Privacy & Security

Is my data safe?

Yes! LAGE is privacy-focused with no data collection, tracking, or third-party data sharing. API keys are stored locally and encrypted by Chrome.

See our Privacy Policy and Security Policy for complete details.

Where is my API key stored?

Your Linear API key is stored locally on your device using Chrome’s secure storage API, encrypted by Chrome. It’s never transmitted except to Linear’s official API.

What permissions does LAGE require?

How do I report a security vulnerability?

Follow our Security Policy to report vulnerabilities responsibly. DO NOT open a public issue.

Pricing & Support

How much does LAGE cost?

LAGE is 100% free with no hidden costs, subscriptions, or paid features. It’s a community-driven open-source project.

How can I support LAGE?

You can support LAGE by:

Where do I get support?

Is there a community?

Yes! Join us:

Technical

What technologies does LAGE use?

Can I contribute to LAGE?

Absolutely! We welcome contributions of all kinds. See our Contributing Guide for details.

How do I build LAGE from source?

# Clone the repository
git clone https://github.com/nelsondaza/linear-and-github-extension.git
cd linear-and-github-extension

# Install dependencies
pnpm install --frozen-lockfile

# Start development server
pnpm dev

# Or build for production
pnpm build

See the README for detailed instructions.

What’s the project structure?

LAGE uses a monorepo structure:

Does LAGE use APIs from Linear?

Yes, LAGE uses Linear’s official GraphQL API. Your API key authenticates requests to this API.

API documentation: Linear Developers

How often does LAGE update?

Check GitHub Releases for updates.

Does LAGE have tests?

Not yet! This is a great area for contribution. We welcome help adding:

What’s on the roadmap?

Upcoming features may include:

See CHANGELOG for details.

Troubleshooting

LAGE isn’t working. What should I do?

  1. Check you’re on a supported GitHub page (PR or compare)
  2. Verify your Linear API key is configured
  3. Reload the GitHub page (hard refresh: Ctrl+Shift+R)
  4. Check browser console for errors (F12)
  5. See the Troubleshooting Guide

Why aren’t my Linear issues showing?

Common causes:

See Linear Issues Not Displaying for solutions.

How do I update LAGE?

Check your version: chrome://extensions/ > LAGE details

Can I use multiple Linear workspaces?

Currently, LAGE supports one API key at a time, which is tied to a single Linear account. If you have access to multiple workspaces under that account, LAGE will work with all of them.

To switch workspaces: Generate a new API key from the other workspace and update LAGE settings.

Multi-workspace support (switching keys without re-entering) is on our wishlist!

Does LAGE slow down GitHub?

LAGE is designed to be lightweight and performant. However:

If you experience performance issues, see Performance Issues.

How do I uninstall LAGE?

  1. Go to chrome://extensions/
  2. Find “Linear And GitHub Extension”
  3. Click “Remove”
  4. Confirm removal

All locally stored data (API key, settings) will be deleted.

Don’t forget to revoke your API key in Linear Settings if you’re not using it anymore!

Still Have Questions?

Can’t find your answer here?

Happy integrating! If you found LAGE helpful, consider starring the repo! ⭐

This site is open source. Improve this page.