agkan

library3.13.0jsnpmunverified

A lightweight, TypeScript-based CLI task management tool using SQLite local storage. Designed for collaborative work with AI agents, it features a Kanban-style workflow with 7 statuses, parent-child and blocking task relationships, tag system, and a local web-based Kanban board. Version 3.13.0, active development. Key differentiators: agent-friendly design with companion skills package for Claude Code, tree view, circular reference detection, and JSON output.

productivity

npm install agkan

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AGKAN

agkan

productivityjavascriptv3.13.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

agkan

✓ import { agkan } from 'agkan'

✗ const agkan = require('agkan')

ESM-only package. CommonJS require is not supported.

runCLI

✓ import { runCLI } from 'agkan/cli'

✗ import { runCLI } from 'agkan'

Programmatic CLI runner is exported from 'agkan/cli'. Not available on default export.

Task

✓ import type { Task } from 'agkan'

✗ import { Task } from 'agkan'

Type import only. Task is not a runtime value.

Install agkan globally, initialize a project, create a task, and list tasks as JSON.

npm install -g agkan agkan init agkan task add "Implement login" "User authentication system" --status ready --author "dev1" agkan task list --json

Debug

Known issues

breakingNode.js 20+ required. agkan v3.13.0 uses SQLite features incompatible with older Node.js versions.

fix

Upgrade Node.js to 20.0.0 or higher.

affects: >=3.0.0

breakingESM-only package. CommonJS require() will fail with ERR_REQUIRE_ESM.

fix

Use import syntax or dynamic import().

affects: >=3.0.0

gotchaThe 'agkan context --hook' command modifies .claude/settings.local.json. If not using Claude Code, the generated file can be ignored but not deleted without loss of hook functionality.

fix

To disable, remove the hook from .claude/settings.local.json manually.

affects: >=3.0.0

deprecatedThe '--outdated' flag on agkan task list is deprecated in favor of '--filter status=done'.

fix

Remove --outdated and use --filter status=done instead.

affects: >=3.5.0 <3.9.0

gotchaCircular reference detection prevents adding blocking relationships that create cycles, but does not warn when querying an existing cycle.

fix

Periodically audit task dependencies with 'agkan task list --graph' to detect unexpected cycles.

affects: >=3.0.0

Errors

Common errors & fixes

Error: Cannot find module 'better-sqlite3'. Require stack: ...

Missing native SQLite build or npm install failure.

fix

Run 'npm install -g agkan' again to rebuild native bindings.

TypeError: agkan.init is not a function

Importing package as CommonJS while it's ESM-only.

fix

Use 'import { agkan } from 'agkan'' or switch to dynamic import.

Error: EACCES: permission denied, open '/usr/local/lib/node_modules/agkan/...'

Global install without proper permissions.

fix

Use 'sudo npm install -g agkan' or configure npm prefix.

Error: SQLITE_ERROR: no such table: tasks

Running agkan commands in a directory without prior 'agkan init'.

fix

Run 'agkan init' first to create the SQLite database.

Upgrade

Version history

3.13.0latest on npm

Audit

Dependencies

better-sqlite3requiredSQLite database bindings for Node.js

commanderrequiredCLI command parsing and routing

chalkrequiredTerminal string coloring

yamlrequiredYAML configuration file parsing

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/gendosu/agkan ↗

packageagkan ↗

homepagehttps://gendosu.github.io/agkan/ ↗