# Kanera 1.5.0: The Kanera CLI and SDK, board health and read-only API keys - Changelog

> Work from a terminal with the new kanera CLI and TypeScript SDK, see which boards need attention, and give AI agents read-only personal API keys.

Canonical page: https://www.kanera.app/changelog/v1-5-0

[All releases](https://www.kanera.app/changelog) 30 Aug 2026 v1.5.0

# The Kanera CLI and SDK, board health and read-only API keys

Kanera now has a command-line tool and a TypeScript SDK. Install the CLI with npm install --global @kanera/cli (Node 22 or newer), sign in with kanera auth login , and run commands such as kanera work , kanera card MKT-42 or kanera card done MKT-42 .

kanera commands --json lists everything the CLI can do, so AI agents that can run shell commands can use it too. kanera setup claude adds the Kanera skill to Claude Code.

The SDK, @kanera/sdk , wraps the public API for Node, Bun, Deno, Cloudflare Workers and browsers. It accepts a card key such as MKT-42 wherever a card is expected, pages through results for you and verifies webhook signatures.

## Give agents read-only API keys

When you create a personal key in Profile settings → API keys , choose Write or Read only . A read-only key can read everything you can access but cannot change content, manage keys or change account settings, which makes it the right key for an AI agent that should only look.

A key's scope cannot be changed after it is created. Personal keys you created before this release keep read and write access.

## See which boards need attention

Select the radar button on a board to open Board overview . It counts active, overdue, unassigned and inactive cards, shows what is due in the next 7 days and how many cards each list holds. Select a count to filter the board to those cards. The button itself shows whether the board is on track, needs attention or is at risk.

A card with no activity for 14 days is marked inactive. Change the period, or choose which signals count towards board health, under Workspace settings → General . Portfolio also shows each board's work risk.

Self-hosting

- Set MCP_SERVER_PUBLIC_URL in .env to your public MCP endpoint before upgrading; Docker Compose now refuses to start without it.
- If you expose MCP, route /.well-known/oauth-protected-resource/mcp to the mcp service as well as /mcp and /.well-known/oauth-protected-resource .
- Postgres, Valkey and the monitoring images are now pinned to exact versions. The usual upgrade command leaves them running; run docker compose up -d postgres valkey to move to the pinned versions.
- New optional MCP settings: MCP_UPSTREAM_TIMEOUT_MS (default 15000 ) and MCP_TOOL_OUTPUT_MAX_BYTES (default 1048576 ).

New features 10
- The kanera command-line tool for cards, comments and Up next from a terminal CLI
- @kanera/sdk , a TypeScript client for the public API SDK
- Personal API keys can be created as read-only API
- Board overview with active, overdue, unassigned, inactive and due-soon counts Boards
- Cards without recent activity are marked inactive, after 14 days by default Boards
- Choose the inactivity period and the signals that count towards board health Settings
- Portfolio shows each board's work risk Reporting
- Examples adds ready-made rules matched to your lists and labels, switched off Automations
- Optionally get device notifications for boards and cards you watch Notifications
- Workspace admins can delete other people's comments on their boards Comments

Improvements 10
- Ctrl K shows quick actions before you type, including creating a card on a board Boards
- A redesigned Up next drawer with a clearer picker for adding cards Up next
- Zoom images in the viewer with the mouse wheel or a pinch, then drag to pan Cards
- Checklist item options are easier to reach and use Cards
- The browser tab icon changes when you have unread notifications Notifications
- People without a profile photo get a generated avatar instead of initials Members
- Turn off Show scratchpad in Profile settings to hide its button Scratchpad
- Settings sections link to the matching help article Settings
- OAuth sign-in and writes work more reliably across MCP clients MCP
- Faster loading across the app, API and live updates Performance

Bug fixes 7
- Switching organisation no longer fails or returns you to the previous one Organisations
- Grouped push notifications display correctly on Android Notifications
- A burst of mentions plays the notification chime once Notifications
- Email and push notifications are delivered more reliably Notifications
- Queues drop cards that are no longer eligible, and teammate queues offer the right cards Up next
- Sub-checklist items no longer offer options they cannot use Cards
- Trello and Kanera imports no longer add the same assignee to a card twice Import

[Older v1.4.0: A private scratchpad, Markdown attachments and safe API retries](https://www.kanera.app/changelog/v1-4-0)[Newer v1.5.1: A Kanera plugin for Codex and better tool choice for AI agents](https://www.kanera.app/changelog/v1-5-1)

## See the latest release On your own boards

Start free with a 30-day Pro trial, or run Kanera on your own servers with the one-command installer.

[Start free](https://board.kanera.app/signup)[Self-host Kanera](https://www.kanera.app/docs/self-host)

## Machine-readable resources

- [Kanera AI index](https://www.kanera.app/llms.txt)
- [Kanera documentation index](https://www.kanera.app/docs/llms.txt)
- [Agent discovery guidance](https://www.kanera.app/agents.md)
