Integration: ticketing and approvals

Linear work tracking AI cost on every issue

Argent Strategic Intelligence books each AI agent's spend to the Linear issue it worked on, rolls it up, holds work at its cap, and writes the cost and a signed summary back to Linear.

01 / INTEGRATION: TICKETING AND APPROVALS

AI spend on the Linear issue it served

AI agents now write code, tests and documents against real work items, and their bill usually arrives as one number at month end. Argent connects to Linear and books every agent's AI spend to the issue it worked on.

  • Your Linear teams, projects and issues appear in Argent's Work catalog, kept in step with Linear.
  • Each request that goes through Argent is priced on Argent's signed ledger and booked to the issue the agent declared, then rolled up through the project to the team.
  • A budget can sit on the issue, the project or the team. At the cap, the work waits for its budget owner.
  • The cost can be written back into Linear, so the issue itself shows what its AI work cost.
02 / INTEGRATION: TICKETING AND APPROVALS

What Argent does with Linear

StepWhat happens
Sync the boardArgent reads the teams, projects and issues on the boards you choose into its Work items, picking up where the last read stopped. Linear wins on state: the sync reads and never overwrites.
Book the spendIn ADE, the Argent Development Environment, the developer picks the issue when launching a session, and the agent can declare the issue it is on with a tool. Each sub-agent's spend is kept separate. Argent books the session's priced spend to that issue, once.
Cap itAn admin sets a cap on an issue, project or team, with a warning at 80 percent. At 100 percent, set to Pause, the next prompt of every ADE session on that work is held until the budget owner chooses Raise cap or One-time overage.
Write the cost backA cost value on each synced issue, equal to its lifetime AI spend and rewritten only when it changes.
Write the work backOn commit, ADE drafts one summary comment (what changed, which files, the cost of that stretch). The developer approves it, Argent removes secrets, signs it and posts it to the issue. Closing the issue in ADE can close it in Linear too.
03 / INTEGRATION: TICKETING AND APPROVALS

How the cost shows up in Linear

Each synced issue can show its lifetime AI spend inside Linear.

Argent posts the cost as one comment on each issue, in the form Argent AI cost: USD <amount>, <count> tokens, and edits that same comment as the cost changes, so the issue always shows one current number.

  • Values are absolute, never increments, so a missed run cannot double-count.
  • A comment or permission Linear refuses shows as a cost error on the connection, with a fixed plain sentence and a signed row, never silently.
  • Cost write-back has its own switch per connection.
04 / INTEGRATION: TICKETING AND APPROVALS

How it connects

Argent talks to Linear's API over HTTPS, as the account or OAuth app you connect.

  • Credential: a Linear OAuth app, or a personal API key of a dedicated Linear user created for Argent.
  • No secret in Argent's database. The credential stays in your vault and Argent stores a reference to it. Works with HashiCorp Vault and OpenBao, AWS Secrets Manager, CyberArk Conjur or Infisical.
  • Guarded calls. Every call goes through Argent's protected HTTPS client, which refuses private addresses and redirects to other hosts. Calls go to Linear's API at api.linear.app.
  • Bounded sync. Each run reads a capped amount, so a misbehaving server cannot stall Argent or fill its database.
  • Plain errors. Failures are stored as fixed codes and sentences; Linear's own response text is never kept.
05 / INTEGRATION: TICKETING AND APPROVALS

What you configure

  1. Create the Linear credential: a Linear OAuth app, or a personal API key of a dedicated Linear user created for Argent. Store it in your vault.
  2. Connect Linear in the Argent console under Work, Trackers, with the address and the vault reference.
  3. Pick the boards to sync. Argent maps Linear's team, project and issue to its own project, feature and story levels.
  4. Turn on the write-backs you want. Every switch ships Off: Summary comment, and Closed workflow state you pick (default Done).
  5. Switch cost write-back on for the connection.
  6. Set budgets on the work items that need a cap, and say whether 100 percent pauses or only alerts.

Spend is booked for agents that work through Argent; ADE is where the developer picks the issue and the agent declares it.

06 / INTEGRATION: TICKETING AND APPROVALS

Signed, and Linear stays in charge

Every write-back is signed in Argent's ledger before it is posted, and refused if the ledger is down.

  • The Tracker sync trail lists each write: the person, the Linear issue, COMMENT, STATUS CHANGE or CLOSE, and POSTED, RETRYING or REFUSED BY TRACKER.
  • Each comment ends with Posted by Argent on behalf of <person>, agent <agent>. and its record id.
  • If someone already moved the issue in Linear, the tracker wins: Argent leaves it as Linear has it.
  • No agent can lift a hold or approve its own comment: every write an agent asks for waits for its human owner.

Hand the trail to an auditor with one-click audit evidence.

07 / INTEGRATION: TICKETING AND APPROVALS

Where this fits

Browse all integrations.