kanon-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kanon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/kanon.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { loginCommand } from '../src/commands/login.js';
+import { boardsCommand } from '../src/commands/boards.js';
+import { initCommand } from '../src/commands/init.js';
+import { cardsCommand } from '../src/commands/cards.js';
+import { watchCommand } from '../src/commands/watch.js';
+import { dashboardCommand } from '../src/commands/dashboard.js';
+import { showCardCommand, createCardCommand, updateCardCommand, archiveCardCommand, boardCommand } from '../src/commands/card.js';
+import { checklistCreateCommand, checklistAddCommand, checklistCheckCommand, checklistUncheckCommand, checklistRemoveCommand } from '../src/commands/checklist.js';
+import { listCreateCommand, listRenameCommand, listDeleteCommand } from '../src/commands/list.js';
+import { labelCreateCommand, labelDeleteCommand } from '../src/commands/label.js';
+import { attachCommand, attachmentsCommand, downloadCommand } from '../src/commands/attachment.js';
+
+const program = new Command();
+
+program
+  .name('kanon')
+  .description('Kanon board CLI')
+  .version('0.2.0');
+
+// --- Auth & Setup ---
+
+program
+  .command('login')
+  .description('Login to Kanon server')
+  .action(loginCommand);
+
+program
+  .command('boards')
+  .description('List all boards')
+  .action(boardsCommand);
+
+program
+  .command('init')
+  .description('Initialize kanon.config.yaml for the current project')
+  .action(initCommand);
+
+program
+  .command('board')
+  .description('Show board context (lists, labels, members)')
+  .action(boardCommand);
+
+// --- Cards list ---
+
+program
+  .command('cards')
+  .description('List cards on the configured board')
+  .option('-l, --label <name>', 'Filter by label name')
+  .option('--list <name>', 'Filter by list name')
+  .option('-m, --mine', 'Show only cards assigned to me')
+  .option('-a, --all', 'Show empty lists too')
+  .action(cardsCommand);
+
+// --- Card (subcommands) ---
+
+const card = program
+  .command('card')
+  .description('Card operations');
+
+card
+  .command('show <cardId>')
+  .description('Show card details')
+  .action(showCardCommand);
+
+// Also allow `kanon card <id>` as shortcut for show
+card
+  .argument('[cardId]')
+  .action((cardId, options, cmd) => {
+    // Only handle if cardId looks like an ID (not a subcommand name)
+    if (cardId && !['create', 'update', 'archive', 'show'].includes(cardId)) {
+      return showCardCommand(cardId);
+    }
+  });
+
+card
+  .command('create <title> <listName>')
+  .description('Create a new card in a list')
+  .option('-d, --description <text>', 'Card description')
+  .option('--label <name...>', 'Add labels (repeatable)')
+  .option('--assign <member...>', 'Assign members (repeatable)')
+  .option('--due <date>', 'Due date (YYYY-MM-DD)')
+  .action(createCardCommand);
+
+card
+  .command('update <cardId>')
+  .description('Update a card (all flags optional, combinable)')
+  .option('-t, --title <text>', 'New title')
+  .option('-d, --description <text>', 'New description')
+  .option('--comment <text>', 'Add a comment')
+  .option('--add-label <name...>', 'Add labels')
+  .option('--remove-label <name...>', 'Remove labels')
+  .option('--move <listName>', 'Move to list')
+  .option('--assign <member...>', 'Assign members')
+  .option('--unassign <member...>', 'Unassign members')
+  .option('--due <date>', 'Set due date (YYYY-MM-DD)')
+  .option('--clear-due', 'Remove due date')
+  .option('--done', 'Mark as done')
+  .option('--undone', 'Mark as not done')
+  .action(updateCardCommand);
+
+card
+  .command('archive <cardId>')
+  .description('Archive a card')
+  .action(archiveCardCommand);
+
+// --- Checklist ---
+// Commander can't cleanly handle `checklist <cardId> <subcommand> <arg>`,
+// so we use a single command with variadic args and route manually.
+
+program
+  .command('checklist')
+  .description('Checklist operations: checklist <cardId> create|add|check|uncheck|remove <text>')
+  .argument('<args...>')
+  .action((args) => {
+    if (args.length < 3) {
+      console.error('Usage: kanon checklist <cardId> create|add|check|uncheck|remove <text>');
+      process.exit(1);
+    }
+    const [cardId, action, ...rest] = args;
+    const text = rest.join(' ');
+    switch (action) {
+      case 'create': return checklistCreateCommand(cardId, text);
+      case 'add':    return checklistAddCommand(cardId, text);
+      case 'check':  return checklistCheckCommand(cardId, text);
+      case 'uncheck': return checklistUncheckCommand(cardId, text);
+      case 'remove': return checklistRemoveCommand(cardId, text);
+      default:
+        console.error(`Unknown checklist action: ${action}`);
+        console.error('Available: create, add, check, uncheck, remove');
+        process.exit(1);
+    }
+  });
+
+// --- List ---
+
+const list = program
+  .command('list')
+  .description('List operations');
+
+list
+  .command('create <title>')
+  .description('Create a new list on the board')
+  .action(listCreateCommand);
+
+list
+  .command('rename <oldName> <newName>')
+  .description('Rename a list')
+  .action(listRenameCommand);
+
+list
+  .command('delete <name>')
+  .description('Archive a list')
+  .action(listDeleteCommand);
+
+// --- Label ---
+
+const label = program
+  .command('label')
+  .description('Label operations');
+
+label
+  .command('create <name>')
+  .description('Create a board label')
+  .option('--color <hex>', 'Label color (#hex)', '#888888')
+  .action(labelCreateCommand);
+
+label
+  .command('delete <name>')
+  .description('Delete a board label')
+  .action(labelDeleteCommand);
+
+// --- Attachments ---
+
+program
+  .command('attach <cardId> <filepath>')
+  .description('Upload a file attachment to a card')
+  .action(attachCommand);
+
+program
+  .command('attachments <cardId>')
+  .description('List attachments on a card')
+  .action(attachmentsCommand);
+
+program
+  .command('download <cardId> <filename>')
+  .description('Download an attachment from a card')
+  .option('--out <path>', 'Output file path')
+  .action(downloadCommand);
+
+// --- Watch & Dashboard ---
+
+program
+  .command('watch')
+  .description('Start the watch daemon')
+  .option('--dry-run', 'Show events without spawning Claude')
+  .action(watchCommand);
+
+program
+  .command('dashboard')
+  .description('Start the web dashboard')
+  .option('-p, --port <port>', 'Dashboard port', '3737')
+  .option('--no-browser', 'Do not open browser automatically')
+  .action(dashboardCommand);
+
+// --- Help all ---
+
+program
+  .command('help-all')
+  .description('Show all commands with full details')
+  .action(() => {
+    console.log(`kanon CLI — Full Command Reference
+
+── Read ───────────────────────────────────────────────────
+  kanon board                              Show board context (lists, labels, members)
+  kanon cards [--list X] [--label X] [-m]  List cards (--mine for assigned to you)
+  kanon card <id>                          Read card details
+
+── Card Operations ────────────────────────────────────────
+  kanon card create <title> <list>         Create card (list is required)
+    --description "text"                     Card description
+    --label "name"                           Add label (repeatable)
+    --assign "member"                        Assign member (repeatable)
+    --due "YYYY-MM-DD"                       Set due date
+
+  kanon card update <id>                   Update card (all flags combinable)
+    --title "text"                           Change title
+    --description "text"                     Change description
+    --comment "text"                         Add a comment
+    --add-label "name"                       Add label (repeatable)
+    --remove-label "name"                    Remove label (repeatable)
+    --move "list name"                       Move to list
+    --assign "member"                        Assign member (repeatable)
+    --unassign "member"                      Unassign member (repeatable)
+    --due "YYYY-MM-DD"                       Set due date
+    --clear-due                              Remove due date
+    --done                                   Mark as done
+    --undone                                 Mark as not done
+
+  kanon card archive <id>                  Archive a card
+
+── Checklists ─────────────────────────────────────────────
+  kanon checklist <cardId> create "title"  Create checklist on card
+  kanon checklist <cardId> add "text"      Add item (auto-creates checklist)
+  kanon checklist <cardId> check "text"    Check item (partial text match)
+  kanon checklist <cardId> uncheck "text"  Uncheck item
+  kanon checklist <cardId> remove "text"   Remove item
+
+── Lists (Board) ──────────────────────────────────────────
+  kanon list create "title"                Create list
+  kanon list rename "old" "new"            Rename list
+  kanon list delete "name"                 Archive list
+
+── Labels (Board) ─────────────────────────────────────────
+  kanon label create "name" [--color #hex] Create label
+  kanon label delete "name"                Delete label
+
+── Attachments ────────────────────────────────────────────
+  kanon attach <cardId> <filepath>         Upload file to card
+  kanon attachments <cardId>               List attachments
+  kanon download <cardId> <filename>       Download attachment (--out path)
+`);
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "kanon-cli",
+  "version": "0.1.0",
+  "description": "Kanon board CLI — watch boards, spawn Claude agents, manage cards",
+  "type": "module",
+  "bin": {
+    "kanon": "./bin/kanon.js"
+  },
+  "scripts": {
+    "start": "node bin/kanon.js",
+    "dev": "node bin/kanon.js"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "express": "^5.1.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/commands/",
+    "src/lib/",
+    "src/prompts/",
+    "src/dashboard/server/",
+    "src/dashboard/dist/",
+    "src/dashboard/package.json"
+  ],
+  "license": "MIT",
+  "private": false
+}

package/src/commands/attachment.js

@@ -0,0 +1,98 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import api from '../lib/api.js';
+import { getToken } from '../lib/config.js';
+
+function requireAuth() {
+  if (!getToken()) {
+    console.error(chalk.red('Not logged in. Run: kanon login'));
+    process.exit(1);
+  }
+}
+
+// --- kanon attach <cardId> <filepath> ---
+
+export async function attachCommand(cardId, filepath) {
+  requireAuth();
+  try {
+    const resolved = path.resolve(filepath);
+    if (!fs.existsSync(resolved)) {
+      console.error(chalk.red(`File not found: ${resolved}`));
+      process.exit(1);
+    }
+    const result = await api.uploadAttachment(cardId, resolved);
+    const name = result.attachment?.filename || result.filename || path.basename(resolved);
+    console.log(chalk.green(`Attached "${name}" to card ${cardId}.`));
+  } catch (err) {
+    console.error(chalk.red(`Failed to upload attachment: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// --- kanon attachments <cardId> ---
+
+export async function attachmentsCommand(cardId) {
+  requireAuth();
+  try {
+    const data = await api.getAttachments(cardId);
+    const attachments = data.attachments || data || [];
+
+    if (!attachments.length) {
+      console.log(chalk.yellow('No attachments on this card.'));
+      return;
+    }
+
+    console.log(chalk.dim(`\nAttachments (${attachments.length}):`));
+    for (const a of attachments) {
+      const name = a.filename || a.name;
+      const size = a.size ? chalk.dim(` (${formatSize(a.size)})`) : '';
+      console.log(`  ${name}${size}`);
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Failed to list attachments: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// --- kanon download <cardId> <filename> [--out "path"] ---
+
+export async function downloadCommand(cardId, filename, options) {
+  requireAuth();
+  try {
+    const data = await api.getAttachments(cardId);
+    const attachments = data.attachments || data || [];
+    const lower = filename.toLowerCase();
+
+    const attachment = attachments.find(a =>
+      (a.filename || a.name || '').toLowerCase().includes(lower)
+    );
+    if (!attachment) {
+      console.error(chalk.red(`Attachment "${filename}" not found on card ${cardId}.`));
+      process.exit(1);
+    }
+
+    const urlData = await api.getAttachmentUrl(cardId, attachment.id);
+    const url = urlData.url || urlData;
+
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`Download failed (${res.status})`);
+
+    const buffer = Buffer.from(await res.arrayBuffer());
+    const outName = attachment.filename || attachment.name || filename;
+    const outPath = options.out ? path.resolve(options.out) : path.resolve(outName);
+
+    fs.writeFileSync(outPath, buffer);
+    console.log(chalk.green(`Downloaded "${outName}" to ${outPath} (${formatSize(buffer.length)}).`));
+  } catch (err) {
+    console.error(chalk.red(`Failed to download attachment: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}

package/src/commands/boards.js

@@ -0,0 +1,39 @@
+import chalk from 'chalk';
+import api from '../lib/api.js';
+import { getToken } from '../lib/config.js';
+
+export async function boardsCommand() {
+  if (!getToken()) {
+    console.error(chalk.red('Not logged in. Run: kanon login'));
+    process.exit(1);
+  }
+
+  try {
+    const data = await api.getTeams();
+    const teams = data.teams || data;
+
+    if (!teams?.length) {
+      console.log(chalk.yellow('No teams found.'));
+      return;
+    }
+
+    for (const team of teams) {
+      console.log(chalk.bold(`\n${team.name}`));
+
+      const boards = team.boards || [];
+      if (!boards.length) {
+        console.log(chalk.dim('  No boards'));
+        continue;
+      }
+
+      for (const board of boards) {
+        const memberCount = board.member_count || board.members?.length || '?';
+        console.log(`  ${chalk.cyan(board.title || board.name)}  ${chalk.dim(board.id)}  (${memberCount} members)`);
+      }
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Failed to fetch boards: ${err.message}`));
+    process.exit(1);
+  }
+}