Skip to content

docs: document Linear Hub triggers - #3963

Open
michaelmwu wants to merge 6 commits into
getpaseo:mainfrom
michaelmwu:agent/linear-hub-docs
Open

docs: document Linear Hub triggers#3963
michaelmwu wants to merge 6 commits into
getpaseo:mainfrom
michaelmwu:agent/linear-hub-docs

Conversation

@michaelmwu

@michaelmwu michaelmwu commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add a Linear application setup guide for OAuth, signed webhooks, required scopes, and workspace connections
  • document comment, assignment, project-scope, team-scope, and native Agent Session triggers
  • provide complete command-comment, Agent Session, and guarded first-draft PR workflows
  • document bounded causal context, native Agent Session activities, security boundaries, activity reporting, and self-hosting requirements

Why

Hub PR #84 merged the proven core Linear trigger integration. This companion documentation covers the follow-up Linear capabilities: Agent Sessions, team routing, and reply behavior.

User impact

Operators can connect a Linear app, route allowlisted reactive events or an explicitly project- or team-scoped autonomous workflow, participate in Linear native Agent Sessions, preserve bounded causal context, and grant GitHub authority only to the workflow step that needs it. The guide identifies Agent Sessions as a Linear Developer Preview capability and calls out the reauthorization required by the agent scopes.

Validation

  • git diff --check
  • oxfmt --check public-docs/hub (23 files)
  • Hub public-docs contract: all 42 YAML examples parsed; removed-authoring guards passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 32e854f75f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread public-docs/hub/triggers/index.md Outdated
Comment thread public-docs/hub/triggers/linear.md Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3df1ff6fc0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread public-docs/hub/triggers/index.md Outdated
Comment thread public-docs/hub/triggers/linear.md
@michaelmwu
michaelmwu force-pushed the agent/linear-hub-docs branch from 3df1ff6 to 926c0d0 Compare August 28, 2026 08:58

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 926c0d0b9c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread public-docs/hub/triggers/linear.md Outdated
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 29, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-29T01:14:39.183785Z 479cebf New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fa71032a24

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread public-docs/hub/faq.md Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 479cebfc0c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread public-docs/hub/concepts.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant