integrations/linear.md Codex Docs, 2026-02-19 20:37 UTC → 2026-05-14 07:00 UTC

1# Use Codex in Linear1# Use Codex in Linear

2 2 

3Run Codex tasks from Linear issues

4 

5Use Codex in Linear to delegate work from issues. Assign an issue to Codex or mention `@Codex` in a comment, and Codex creates a cloud task and replies with progress and results.3Use Codex in Linear to delegate work from issues. Assign an issue to Codex or mention `@Codex` in a comment, and Codex creates a cloud task and replies with progress and results.

6 4 

7Codex in Linear is available on paid plans (see [Pricing](https://developers.openai.com/codex/pricing)).5Codex in Linear is available on paid plans (see [Pricing](https://developers.openai.com/codex/pricing)).

22 20 

23After you install the integration, you can assign issues to Codex the same way you assign them to teammates. Codex starts work and posts updates back to the issue.21After you install the integration, you can assign issues to Codex the same way you assign them to teammates. Codex starts work and posts updates back to the issue.

24 22 

25![Assigning Codex to a Linear issue (light mode)](/images/codex/integrations/linear-assign-codex-light.webp)![Assigning Codex to a Linear issue (dark mode)](/images/codex/integrations/linear-assign-codex-dark.webp)23<div class="not-prose max-w-3xl mr-auto my-4">

24 <img src="https://developers.openai.com/images/codex/integrations/linear-assign-codex-light.webp"

25 alt="Assigning Codex to a Linear issue (light mode)"

26 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"

27 />

28 <img src="https://developers.openai.com/images/codex/integrations/linear-assign-codex-dark.webp"

29 alt="Assigning Codex to a Linear issue (dark mode)"

30 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"

31 />

32</div>

26 33 

27### Mention `@Codex` in comments34### Mention `@Codex` in comments

28 35 

29You can also mention `@Codex` in comment threads to delegate work or ask questions. After Codex replies, follow up in the thread to continue the same session.36You can also mention `@Codex` in comment threads to delegate work or ask questions. After Codex replies, follow up in the thread to continue the same session.

30 37 

31![Mentioning Codex in a Linear issue comment (light mode)](/images/codex/integrations/linear-comment-light.webp)![Mentioning Codex in a Linear issue comment (dark mode)](/images/codex/integrations/linear-comment-dark.webp)38<div class="not-prose max-w-3xl mr-auto my-4">

39 <img src="https://developers.openai.com/images/codex/integrations/linear-comment-light.webp"

40 alt="Mentioning Codex in a Linear issue comment (light mode)"

41 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"

42 />

43 <img src="https://developers.openai.com/images/codex/integrations/linear-comment-dark.webp"

44 alt="Mentioning Codex in a Linear issue comment (dark mode)"

45 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"

46 />

47</div>

32 48 

33After Codex starts working on an issue, it [chooses an environment and repo](#how-codex-chooses-an-environment-and-repo) to work in.49After Codex starts working on an issue, it [chooses an environment and repo](#how-codex-chooses-an-environment-and-repo) to work in.

34To pin a specific repo, include it in your comment, for example: `@Codex fix this in openai/codex`.50To pin a specific repo, include it in your comment, for example: `@Codex fix this in openai/codex`.

58Linear assigns new issues that enter triage to Codex automatically.74Linear assigns new issues that enter triage to Codex automatically.

59When you use triage rules, Codex runs tasks using the account of the issue creator.75When you use triage rules, Codex runs tasks using the account of the issue creator.

60 76 

61![Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (light mode)](/images/codex/integrations/linear-triage-rule-light.webp)![Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (dark mode)](/images/codex/integrations/linear-triage-rule-dark.webp)77<div class="not-prose max-w-3xl mr-auto my-4">

78 <img src="https://developers.openai.com/images/codex/integrations/linear-triage-rule-light.webp"

79 alt='Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (light mode)'

80 class="block h-auto w-full rounded-lg border border-default my-0 dark:hidden"

81 />

82 <img src="https://developers.openai.com/images/codex/integrations/linear-triage-rule-dark.webp"

83 alt='Screenshot of an example triage rule assigning everything to Codex and labeling it in the "Triage" status (dark mode)'

84 class="hidden h-auto w-full rounded-lg border border-default my-0 dark:block"

85 />

86</div>

62 87 

63## Data usage, privacy, and security88## Data usage, privacy, and security

64 89 

65When you mention `@Codex` or assign an issue to it, Codex receives your issue content to understand your request and create a task.90When you mention `@Codex` or assign an issue to it, Codex receives your issue content to understand your request and create a task.

66Data handling follows OpenAI's [Privacy Policy](https://openai.com/privacy), [Terms of Use](https://openai.com/terms/), and other applicable [policies](https://openai.com/policies).91Data handling follows OpenAI's [Privacy Policy](https://openai.com/privacy), [Terms of Use](https://openai.com/terms/), and other applicable [policies](https://openai.com/policies).

67For more on security, see the [Codex security documentation](https://developers.openai.com/codex/security).92For more on security, see the [Codex security documentation](https://developers.openai.com/codex/agent-approvals-security).

68 93 

69Codex uses large language models that can make mistakes. Always review answers and diffs.94Codex uses large language models that can make mistakes. Always review answers and diffs.

70 95