LinearPlus

LinearPlus is a small CLI-first bridge for Linear API capabilities that are not reliably exposed through the current connector surface.

The first workflow is initiative management:

• Create or reuse a Linear initiative by name.
• Attach an existing Linear project to an initiative.
• Emit redacted JSON evidence suitable for Eidos/Codex loops.

Credentials

Set one of these environment variables:

export LINEAR_API_KEY="..."

or:

export LINEARPLUS_LINEAR_API_KEY="..."

LinearPlus never prompts for tokens, prints tokens, or writes tokens to repo files.

Pairing For A Linear API Key

LinearPlus uses a human pairing step for credentials. It does not manage tokens.

1. Run the intended command with --dry-run first when available.

2. Create or select a Linear personal API key in Settings > Account > Security & Access.

3. If member keys are unavailable, ask a Linear admin to check Settings > Administration > API > Member API keys.

4. Put the key in a local shell or vault-backed environment variable:

   export LINEARPLUS_LINEAR_API_KEY="..."

5. Verify only presence, not value:

   test -n "$LINEARPLUS_LINEAR_API_KEY" || test -n "$LINEAR_API_KEY"

6. Run the narrow approved live command and capture redacted evidence.

Linear references:

• https://linear.app/docs/api-and-webhooks
• https://linear.app/developers/graphql

Greenmark Bootstrap

Dry run:

python -m linearplus.cli greenmark-bootstrap --dry-run

Live run:

python -m linearplus.cli greenmark-bootstrap

The live run creates or reuses the Greenmark AI Search Visibility initiative and attaches project 079b8875-9c80-41c8-b4b0-ea09834a7065.

Generic Commands

python -m linearplus.cli initiative-get --name "Greenmark AI Search Visibility"
python -m linearplus.cli initiative-ensure --name "Greenmark AI Search Visibility" --status Planned
python -m linearplus.cli attach-project --initiative-id <initiative-id> --project-id <project-id>