Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.foggyhq.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect Linear so Foggy can surface related issues during an investigation and — with a full-access key — file a ticket from the findings.

What Foggy can do

ToolDescription
IssuesSearch, read, and (with full-access key) create issues
ProjectsRead project metadata
CyclesRead active and recent cycles
TeamsRead teams and members
CommentsRead issue comments

Setup

Go to ConnectorsAdd ConnectorLinear and fill in the form.
FieldRequiredDescription
NameYesLabel for this connector (e.g. “Linear-Workspace”)
API KeyYesLinear → SettingsAccountSecurity & Access. A Restricted key is read-only. A full-access key lets Foggy file tickets.
Pick the narrowest key that works. If you only want Foggy to reference existing issues in its answers, use a restricted read-only key. Upgrade to full-access only when you want Foggy to file tickets from investigation findings.

Troubleshooting

  • “Permission denied” on issue create — the key is a restricted key. Re-issue as a full-access key, or keep the restricted key if you don’t want Foggy to file tickets.
  • Empty team or project list — Linear scopes are workspace-wide, but the key may have been created in a different workspace than expected. Regenerate from the workspace you want Foggy to see.

Next steps

GitHub

Pair Linear with GitHub to link issues, PRs, and commits.

Slack

Get investigation results where your team already talks.