lineman

n8n community node for Lineman — read AI-coding cost, savings, allowance and alerts in your workflows, and drive Lineman admin settings.

Package Information

Released: 2 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2

Available Nodes

Documentation generating…

Lineman icon
Lineman
Read AI-coding cost, savings, allowance and alerts, and drive Lineman admin settings
Lineman Trigger icon
Lineman Trigger
Starts the workflow when a new Lineman company cost alert fires

Documentation

n8n-nodes-lineman

An n8n community node for Lineman — read
your AI-coding cost, savings, allowance and alerts in a workflow, and drive Lineman
admin settings, with zero Split-Out / Set / Code nodes.

Lineman is an AI-powered code assistant that saves cloud-LLM tokens on data-heavy
tasks. This node talks to the Lineman /v1 partner API, whose responses are
already flat, snake_case, dual-unit money (*_micro + *_usd, never cents),
ISO-8601 time, and top-level arrays — so a workflow author maps them straight to
items.

Credentials

Create a Lineman API credential:

  • API Key — a durable key from Dashboard → Keys (a fa_live_ key). Do
    not     paste the token the Lineman CLI/plugin uses — it rotates every ~15 minutes
    and would 401 mid-workflow. Minting a key needs MFA step-up; each user may hold
    up to 10 active keys.
  • Base URL — defaults to https://n8n.lineman.io/v1. Override for staging
    (https://n8n.staging.lineman.io/v1) or a self-hosted control-api.

The credential test hits GET /v1/me.

Nodes

Lineman (action)

Resource Operations
Account Get Identity
Spend Get Summary, Get Breakdown, Get Top Spenders, Get Over Time, Get Recent Activity, Get Ledger
Savings Get Allowance, Get Savings Summary, Get Savings By Task
Cost Centre List, Get Allocation Report, Create, Update, Delete, Reorder
Member List, Set Budget
Repo List
Company Get Summary
Alert Get Company Alerts, Dismiss, Authorise Repo
Subscription Get Mix

Company-wide reads (spend, alerts, company, members, repos, subscription) want a
manager (administrator/auditor) key; spend reads silently degrade to your own
data (scope:"self") for a non-manager rather than erroring. Every write is
administrator-only and takes flat inputs (dollar amounts, comma-separated lists).
The Ledger supports Return-All offset pagination + a since_ts keyset cursor.

Lineman Trigger (polling)

On New Company Alert — polls GET /v1/alerts?status=active and fires once per
newly-active company alert (manager keys only). For the lowest latency, prefer the
real-time alert-webhook push instead: point Lineman's alert webhook at an n8n
Webhook node (Dashboard → Cost Controls).

Go-live checklist (for the Lineman operator)

This package is code-complete and reserved as a git submodule in the Lineman
monorepo. To publish it:

  1. Deploy /v1 to the live host. Apply the TFC n8n.lineman.io domain mapping
    • LINEMAN_N8N_HOST (LIN-3397) so https://n8n.lineman.io/v1/me answers.
  2. Create the public GitHub repo lineman-io/n8n-nodes-lineman and push this
    working copy to it (the submodule's origin is already set to it).
  3. Verify + publish: npm install && npm run build && npm run lint, then publish
    via a GitHub Actions workflow with npm provenance (mandatory since
    2026-05-01) to keep the verified-community-node track open.
  4. Submit for n8n Cloud verification (zero runtime deps ✓, MIT ✓, public repo ✓).

The /v1 contract this node consumes is documented in the monorepo at
docs/runbooks/v1-partner-api.md.

License

MIT © Goo Holdings Ltd (trading as Lineman)

Discussion