Kaiten

@magistr/kaitenv2026.08.19.1· 3d agoMODELS

01README

Kaiten work-management REST API (read-only) — list/get spaces, boards, columns, and cards with token auth, offset/limit pagination, and 429 back-off

02Models1

@magistr/kaitenv2026.08.19.1extensions/models/kaiten.ts

Global Arguments

Argument	Type	Required	Description
domain	string	yes	Kaiten account domain. Either a bare subdomain (e.g. "acme" ->
apiVersion	string	yes	API version segment in the base path, e.g. "latest" or "v1".
token	string	yes	Personal API token (Bearer). Use a vault reference:
timeoutMs	number	yes	Per-request fetch timeout in milliseconds.
maxRetries	number	yes	How many times to retry a request after an HTTP 429 rate-limit response.
userAgent	string	yes	User-Agent header sent on all outbound requests.

fn listSpaces()

List all spaces (GET /spaces). Writes one `space` per space plus a

fn getSpace(id: number)

Fetch a single space by id (GET /spaces/{id}).

Argument	Type	Required	Description
id	number	yes	Space id.

fn listBoards(spaceId: number)

List boards within a space (GET /spaces/{spaceId}/boards). Writes one

Argument	Type	Required	Description
spaceId	number	yes	Space id whose boards to list.

fn getBoard(id: number)

Fetch a single board by id (GET /boards/{id}); the response embeds

Argument	Type	Required	Description
id	number	yes	Board id. The response embeds the board's columns and lanes.

fn listColumns(boardId: number)

List the columns of a board (GET /boards/{boardId}/columns). Writes

Argument	Type	Required	Description
boardId	number	yes	Board id whose columns to list.

fn listCards(spaceId?: number, boardId?: number, columnId?: number, laneId?: number, query?: string, condition?: enum, archived?: boolean, additionalParams: record, maxResults: number, pageSize: number)

List cards (GET /cards), paginating through all pages up to

Argument	Type	Required	Description
spaceId?	number	no	Filter by space id.
boardId?	number	no	Filter by board id.
columnId?	number	no	Filter by column id.
laneId?	number	no	Filter by lane id.
query?	string	no	Free-text search over card titles.
condition?	enum	no	Card condition filter: live (active) or done. Mapped to Kaiten's
archived?	boolean	no	Include only archived (true) or only non-archived (false) cards.
additionalParams	record	yes	Extra raw query parameters passed through to GET /cards verbatim, e.g.
maxResults	number	yes	Upper bound on cards retrieved across all pages.
pageSize	number	yes	Cards per page request (offset/limit pagination).

fn getCard(id: number)

Fetch a single card by id (GET /cards/{id}).

Argument	Type	Required	Description
id	number	yes	Card id.

Resources

space(infinite)— One Kaiten space (factory output).

board(infinite)— One Kaiten board, with embedded columns and lanes.

column(infinite)— One board column (factory output).

card(infinite)— One Kaiten card (factory output).

summary(infinite)— Per-listing summary: scope, filters, count, and item ids.

03Previous Versions1

2026.06.21.1Jul 16, 2026

Release 2026.07.16.2 — align model versions with manifests

Maintenance release across the @magistr extensions. For most packages this carries no functional change: the only edit is the model's version: field, brought back in line with its manifest version so the published model type version and the package version no longer drift.

Functional changes in this release are limited to:

anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.
arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.

Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.

04Stats

100 / 100

Downloads

Archive size

14.3 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/umag/swamp-workspace

05Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

06Labels

#kaiten #kanban #project-management #task-tracking