lytos-cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frederic Galliné
+
+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/README.md

@@ -0,0 +1,66 @@
+# Lytos — CLI
+
+[![CI](https://github.com/getlytos/lytos-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/getlytos/lytos-cli/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/lytos)](https://www.npmjs.com/package/lytos-cli)
+
+> The command-line tool for [Lytos](https://github.com/getlytos/lytos-method) — a human-first method for working with AI agents.
+
+---
+
+## Install
+
+```bash
+npm install -g lytos-cli
+```
+
+Then use:
+
+```bash
+lytos init          # Install Lytos in your project
+lytos board         # Regenerate BOARD.md from issue frontmatter
+```
+
+Or use without installing:
+
+```bash
+npx lytos init
+```
+
+---
+
+## What it does
+
+One command to install the method, one command to validate your setup, one command to see your sprint.
+
+| Command | What it does |
+|---------|-------------|
+| `lytos init` | Scaffold `.lytos/` in your project (interactive, detects your stack) |
+| `lytos board` | Regenerate BOARD.md from issue YAML frontmatter |
+| `lytos lint` | Validate `.lytos/` structure and content *(coming soon)* |
+| `lytos doctor` | Full diagnostic — missing files, broken links, stale memory *(coming soon)* |
+| `lytos status` | Display sprint DAG in terminal *(coming soon)* |
+
+---
+
+## Built with Lytos
+
+This project uses Lytos to develop itself. The `.lytos/` directory contains the real manifest, sprint, issues, and memory for this project — not templates.
+
+If you want to contribute, open this repo in Claude Code and say: **"Help me understand this project."**
+
+---
+
+## Author
+
+Created by **Frederic Galliné** — [ubeez.com](https://ubeez.com)
+
+- GitHub: [@FredericGalline](https://github.com/FredericGalline)
+- X: [@fred](https://x.com/fred)
+
+Part of the [Lytos](https://github.com/getlytos/lytos-method) project.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE)

package/dist/cli.js

@@ -0,0 +1,995 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command as Command3 } from "commander";
+
+// src/commands/init.ts
+import { Command } from "commander";
+import { existsSync as existsSync3 } from "fs";
+import { basename, resolve } from "path";
+import { createInterface } from "readline";
+
+// src/lib/detect-stack.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+var detectors = [
+  {
+    file: "package.json",
+    detect: (content) => {
+      const pkg = JSON.parse(content);
+      const deps = {
+        ...pkg.dependencies,
+        ...pkg.devDependencies
+      };
+      const stack = {};
+      if (deps.typescript || deps["ts-node"]) {
+        stack.language = "TypeScript";
+      } else {
+        stack.language = "JavaScript";
+      }
+      if (deps.next) stack.framework = "Next.js";
+      else if (deps.nuxt) stack.framework = "Nuxt";
+      else if (deps.react) stack.framework = "React";
+      else if (deps.vue) stack.framework = "Vue";
+      else if (deps.svelte || deps["@sveltejs/kit"]) stack.framework = "SvelteKit";
+      else if (deps.express) stack.framework = "Express";
+      else if (deps.fastify) stack.framework = "Fastify";
+      else if (deps.hono) stack.framework = "Hono";
+      else if (deps.astro) stack.framework = "Astro";
+      if (deps.prisma || deps["@prisma/client"]) stack.database = "Prisma";
+      else if (deps.mongoose) stack.database = "MongoDB (Mongoose)";
+      else if (deps.pg) stack.database = "PostgreSQL";
+      else if (deps.mysql2) stack.database = "MySQL";
+      else if (deps.drizzle || deps["drizzle-orm"]) stack.database = "Drizzle ORM";
+      if (deps.vitest) stack.tests = "Vitest";
+      else if (deps.jest) stack.tests = "Jest";
+      else if (deps["@playwright/test"]) stack.tests = "Playwright";
+      else if (deps.mocha) stack.tests = "Mocha";
+      if (existsSync("bun.lockb")) stack.packageManager = "Bun";
+      else if (existsSync("pnpm-lock.yaml")) stack.packageManager = "pnpm";
+      else if (existsSync("yarn.lock")) stack.packageManager = "Yarn";
+      else stack.packageManager = "npm";
+      return stack;
+    }
+  },
+  {
+    file: "requirements.txt",
+    detect: (content) => {
+      const stack = { language: "Python" };
+      const lower = content.toLowerCase();
+      if (lower.includes("fastapi")) stack.framework = "FastAPI";
+      else if (lower.includes("django")) stack.framework = "Django";
+      else if (lower.includes("flask")) stack.framework = "Flask";
+      if (lower.includes("sqlalchemy")) stack.database = "SQLAlchemy";
+      else if (lower.includes("psycopg")) stack.database = "PostgreSQL";
+      else if (lower.includes("pymongo")) stack.database = "MongoDB";
+      if (lower.includes("pytest")) stack.tests = "Pytest";
+      return stack;
+    }
+  },
+  {
+    file: "pyproject.toml",
+    detect: (content) => {
+      const stack = { language: "Python" };
+      const lower = content.toLowerCase();
+      if (lower.includes("fastapi")) stack.framework = "FastAPI";
+      else if (lower.includes("django")) stack.framework = "Django";
+      else if (lower.includes("flask")) stack.framework = "Flask";
+      if (lower.includes("pytest")) stack.tests = "Pytest";
+      return stack;
+    }
+  },
+  {
+    file: "go.mod",
+    detect: (content) => {
+      const stack = { language: "Go" };
+      if (content.includes("gin-gonic")) stack.framework = "Gin";
+      else if (content.includes("gorilla/mux")) stack.framework = "Gorilla Mux";
+      else if (content.includes("labstack/echo")) stack.framework = "Echo";
+      else if (content.includes("gofiber")) stack.framework = "Fiber";
+      return stack;
+    }
+  },
+  {
+    file: "Cargo.toml",
+    detect: (content) => {
+      const stack = { language: "Rust" };
+      if (content.includes("actix-web")) stack.framework = "Actix Web";
+      else if (content.includes("axum")) stack.framework = "Axum";
+      else if (content.includes("rocket")) stack.framework = "Rocket";
+      return stack;
+    }
+  },
+  {
+    file: "composer.json",
+    detect: (content) => {
+      const pkg = JSON.parse(content);
+      const stack = { language: "PHP" };
+      const req = JSON.stringify(pkg.require || {}).toLowerCase();
+      if (req.includes("laravel")) stack.framework = "Laravel";
+      else if (req.includes("symfony")) stack.framework = "Symfony";
+      else if (req.includes("wordpress")) stack.framework = "WordPress";
+      if (req.includes("phpunit")) stack.tests = "PHPUnit";
+      return stack;
+    }
+  }
+];
+function detectStack(cwd) {
+  let result = {};
+  for (const detector of detectors) {
+    const filePath = join(cwd, detector.file);
+    if (existsSync(filePath)) {
+      try {
+        const content = readFileSync(filePath, "utf-8");
+        result = { ...result, ...detector.detect(content, cwd) };
+      } catch {
+      }
+    }
+  }
+  return result;
+}
+
+// src/lib/scaffold.ts
+import { mkdirSync, writeFileSync, existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/lib/templates.ts
+var REPO_URL = "https://github.com/getlytos/lytos-method";
+function manifestTemplate(ctx) {
+  const stackRows = [
+    `| Language | ${ctx.stack.language || ""} |`,
+    `| Framework | ${ctx.stack.framework || ""} |`,
+    `| Database | ${ctx.stack.database || ""} |`,
+    `| Tests | ${ctx.stack.tests || ""} |`
+  ].join("\n");
+  return `# Manifest \u2014 ${ctx.projectName}
+
+*This file is the project's constitution. It is read by agents at the start of each work session.*
+
+---
+
+## Identity
+
+| Field | Value |
+|-------|-------|
+| Name | ${ctx.projectName} |
+| Description | |
+| Owner | |
+| Repo | |
+
+---
+
+## Why this project exists
+
+*3-5 sentences. The "why" of this project.*
+
+---
+
+## What this project is
+
+-
+
+## What this project is not
+
+-
+
+---
+
+## Tech stack
+
+| Component | Technology |
+|-----------|------------|
+${stackRows}
+
+---
+
+## Project vocabulary
+
+| Term | Definition |
+|------|-----------|
+| | |
+
+---
+
+## Development principles
+
+*When an agent hesitates between two approaches, it consults these principles to decide. Formulate as trade-offs: "we prefer X over Y, because Z."*
+
+-
+-
+
+---
+
+## AI models by complexity
+
+*Map your own models based on your budget and tools. Update when better models come out.*
+
+| Complexity | Usage | Model |
+|------------|-------|-------|
+| \`light\` | Documentation, formatting, renaming, boilerplate | |
+| \`standard\` | Day-to-day development, code review, tests | |
+| \`heavy\` | Complex architecture, critical algorithms, security | |
+
+---
+
+## Important links
+
+| Resource | URL |
+|----------|-----|
+| Main repo | |
+| Documentation | |
+| Staging | |
+| Production | |
+
+---
+
+*Last updated: ${ctx.date}*
+`;
+}
+function memoryTemplate(ctx) {
+  return `# Memory \u2014 ${ctx.projectName}
+
+*This file is the project memory's table of contents. Do not read everything \u2014 load only what is relevant to the current task.*
+
+> **Last updated**: ${ctx.date}
+> **Number of entries**: 0
+
+---
+
+## Section index
+
+| File | Content | Load when... |
+|------|---------|--------------|
+| [architecture.md](./cortex/architecture.md) | Architectural decisions, technical choices | Any structural task |
+| [backend.md](./cortex/backend.md) | Server-side patterns and pitfalls | Backend task |
+| [frontend.md](./cortex/frontend.md) | Client-side patterns and pitfalls | Frontend task |
+| [patterns.md](./cortex/patterns.md) | Recurring code patterns | Code review, new code |
+| [bugs.md](./cortex/bugs.md) | Recurring problems and solutions | Debug, fix |
+| [business.md](./cortex/business.md) | Business context, vocabulary | Business logic, UX |
+| [sprints.md](./cortex/sprints.md) | Sprint history | Planning |
+
+---
+
+## Living summary
+
+*3-5 lines. The current state of the project at a glance.*
+
+---
+
+*The folder is the structure. The file is the content. This table of contents is the map.*
+`;
+}
+var cortexFiles = [
+  {
+    name: "architecture.md",
+    title: "Architecture & Technical Decisions",
+    description: "Load this file for any task that affects the project structure.",
+    example: `### ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)} \u2014 Database choice
+
+**Context**: Hesitation between SQLite (simple) and PostgreSQL (robust).
+**Decision**: PostgreSQL from the start.
+**Consequence**: Requires Docker for local dev, but no painful migration later.`
+  },
+  {
+    name: "backend.md",
+    title: "Backend",
+    description: "Load this file for any backend task: API, database, services.",
+    example: `### Key files
+
+| File | Role |
+|------|------|
+| \`src/main.py\` | Application entry point |
+| \`src/models/\` | Data models |
+| \`src/routes/\` | API endpoints |`
+  },
+  {
+    name: "frontend.md",
+    title: "Frontend",
+    description: "Load this file for any frontend task: UI, components, styles.",
+    example: `### Key files
+
+| File | Role |
+|------|------|
+| \`src/App.tsx\` | Root component |
+| \`src/components/\` | Reusable components |
+| \`src/hooks/\` | Custom hooks |`
+  },
+  {
+    name: "patterns.md",
+    title: "Discovered Patterns",
+    description: "Load this file for code review, refactoring, or writing new code.",
+    example: `### Pattern name
+
+**What**: One-sentence description of the pattern.
+**Where**: File(s) where it is applied.
+**Why it works**: What makes it effective in this context.`
+  },
+  {
+    name: "bugs.md",
+    title: "Recurring Problems & Solutions",
+    description: "Load this file before debugging \u2014 the problem may have already been solved.",
+    example: `| Problem | Cause | Solution |
+|---------|-------|----------|
+| Tests fail on CI but pass locally | Missing env variables in pipeline | Add secrets in CI settings |`
+  },
+  {
+    name: "business.md",
+    title: "Business Context",
+    description: "Load this file for any task involving business logic or UX.",
+    example: `### Business concept name
+
+**Rule**: What the business requires.
+**Why**: The business reason (not technical).
+**Code impact**: What this means concretely in the code.`
+  },
+  {
+    name: "sprints.md",
+    title: "Sprint History",
+    description: "Load this file at sprint start, retrospective, or planning.",
+    example: `| Sprint | Objective | Result | Key learning |
+|--------|-----------|--------|--------------|`
+  }
+];
+function cortexTemplate(file) {
+  return `# Memory \u2014 ${file.title}
+
+*${file.description}*
+
+---
+
+<!-- Example to adapt or remove:
+
+${file.example}
+
+-->
+`;
+}
+function getCortexFiles() {
+  return cortexFiles;
+}
+function boardTemplate(ctx) {
+  return `# Issue Board \u2014 ${ctx.projectName}
+
+> Each issue = a \`ISS-XXXX-title.md\` file in the folder matching its status.
+>
+> **Last updated**: ${ctx.date}
+> **Next number**: ISS-0001
+
+> Regenerate: \`npx lytos board\`
+
+---
+
+## Issue index
+
+### 0-icebox (ideas)
+
+_No issues._
+
+### 1-backlog (prioritized)
+
+_No issues._
+
+### 2-sprint (committed)
+
+_No issues._
+
+### 3-in-progress (in dev)
+
+_No issues._
+
+### 4-review (review/test)
+
+_No issues._
+
+### 5-done (completed)
+
+_No issues._
+
+---
+
+*The YAML frontmatter is the source of truth. The folder is the visual status. The BOARD.md is the map.*
+`;
+}
+function claudeTemplate(_ctx) {
+  return `# CLAUDE.md
+
+This project uses **Lytos** \u2014 a human-first method for working with AI agents.
+
+## First session (setup)
+
+If the manifest is empty or incomplete, read first:
+- .lytos/LYTOS.md \u2014 understand the method and how to help fill the files
+
+## Every session
+
+Read these files in order:
+1. .lytos/manifest.md \u2014 the project constitution (identity, stack, principles, AI models)
+2. .lytos/memory/MEMORY.md \u2014 the memory summary (then load relevant cortex/ sections)
+3. .lytos/rules/default-rules.md \u2014 quality criteria
+
+## To work on a task
+
+4. .lytos/issue-board/BOARD.md \u2014 board state
+5. .lytos/skills/session-start.md \u2014 full start and end-of-task procedure
+
+## Rules
+
+- The YAML frontmatter of issues is the source of truth
+- Don't interpret silently \u2014 ask if an instruction is ambiguous
+- At end of task: update frontmatter, move the file, update BOARD.md
+- Check the issue's \`complexity\` field + the manifest table for which model to use
+
+Documentation: ${REPO_URL}
+`;
+}
+function cursorrTemplate(_ctx) {
+  return `This project uses Lytos \u2014 a human-first method for working with AI agents.
+
+First session (setup): if the manifest is empty, read @.lytos/LYTOS.md to understand the method.
+
+Every session, read in order:
+1. @.lytos/manifest.md \u2014 the project constitution
+2. @.lytos/memory/MEMORY.md \u2014 the memory summary (then relevant cortex/ sections)
+3. @.lytos/rules/default-rules.md \u2014 quality criteria
+
+To work on a task:
+4. @.lytos/issue-board/BOARD.md \u2014 board state
+5. @.lytos/skills/session-start.md \u2014 start and end-of-task procedure
+
+Rules:
+- The YAML frontmatter of issues is the source of truth
+- Don't interpret silently \u2014 ask if an instruction is ambiguous
+- At end of task: update frontmatter, move the file, update BOARD.md
+- Check the issue's complexity field + the manifest table for the model to use
+
+Documentation: ${REPO_URL}
+`;
+}
+
+// src/lib/scaffold.ts
+var REPO_RAW = "https://raw.githubusercontent.com/getlytos/lytos-method/main";
+var SKILLS = [
+  "session-start",
+  "code-review",
+  "testing",
+  "documentation",
+  "git-workflow",
+  "code-structure",
+  "deployment",
+  "security",
+  "api-design"
+];
+var REMOTE_FILES = [
+  ...SKILLS.map((s) => ({
+    remote: `skills/${s}.md`,
+    local: `skills/${s}.md`
+  })),
+  { remote: "rules/default-rules.md", local: "rules/default-rules.md" },
+  { remote: "rules/README.md", local: "rules/README.md" },
+  { remote: "LYTOS.md", local: "LYTOS.md" },
+  { remote: "templates/sprint.md", local: "templates/sprint.md" },
+  {
+    remote: "issue-board/templates/issue-feature.md",
+    local: "issue-board/templates/issue-feature.md"
+  },
+  {
+    remote: "issue-board/templates/issue-task.md",
+    local: "issue-board/templates/issue-task.md"
+  }
+];
+async function download(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: ${response.status}`);
+  }
+  return response.text();
+}
+function ensureDir(dir, dryRun) {
+  if (!dryRun && !existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function writeFile(path, content, dryRun, result) {
+  if (dryRun) {
+    result.filesCreated.push(path);
+    return;
+  }
+  ensureDir(join2(path, ".."), false);
+  writeFileSync(path, content, "utf-8");
+  result.filesCreated.push(path);
+}
+async function scaffold(options) {
+  const result = {
+    filesCreated: [],
+    filesSkipped: [],
+    warnings: []
+  };
+  const lytosDir = join2(options.cwd, ".lytos");
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const ctx = {
+    projectName: options.projectName,
+    date: today,
+    stack: options.stack
+  };
+  const dirs = [
+    "memory/cortex",
+    "rules",
+    "skills",
+    "scripts",
+    "templates",
+    "issue-board/0-icebox",
+    "issue-board/1-backlog",
+    "issue-board/2-sprint",
+    "issue-board/3-in-progress",
+    "issue-board/4-review",
+    "issue-board/5-done",
+    "issue-board/templates"
+  ];
+  for (const dir of dirs) {
+    ensureDir(join2(lytosDir, dir), options.dryRun);
+  }
+  const kanbanDirs = [
+    "0-icebox",
+    "1-backlog",
+    "2-sprint",
+    "3-in-progress",
+    "4-review",
+    "5-done"
+  ];
+  for (const dir of kanbanDirs) {
+    writeFile(
+      join2(lytosDir, "issue-board", dir, ".gitkeep"),
+      "",
+      options.dryRun,
+      result
+    );
+  }
+  writeFile(
+    join2(lytosDir, "manifest.md"),
+    manifestTemplate(ctx),
+    options.dryRun,
+    result
+  );
+  writeFile(
+    join2(lytosDir, "memory", "MEMORY.md"),
+    memoryTemplate(ctx),
+    options.dryRun,
+    result
+  );
+  writeFile(
+    join2(lytosDir, "issue-board", "BOARD.md"),
+    boardTemplate(ctx),
+    options.dryRun,
+    result
+  );
+  for (const cortexFile of getCortexFiles()) {
+    writeFile(
+      join2(lytosDir, "memory", "cortex", cortexFile.name),
+      cortexTemplate(cortexFile),
+      options.dryRun,
+      result
+    );
+  }
+  for (const file of REMOTE_FILES) {
+    try {
+      const content = await download(`${REPO_RAW}/${file.remote}`);
+      writeFile(
+        join2(lytosDir, file.local),
+        content,
+        options.dryRun,
+        result
+      );
+    } catch (err) {
+      result.warnings.push(
+        `Could not download ${file.remote}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  if (options.tool === "claude") {
+    writeFile(
+      join2(options.cwd, "CLAUDE.md"),
+      claudeTemplate(ctx),
+      options.dryRun,
+      result
+    );
+  } else if (options.tool === "cursor") {
+    writeFile(
+      join2(options.cwd, ".cursorrules"),
+      cursorrTemplate(ctx),
+      options.dryRun,
+      result
+    );
+  }
+  return result;
+}
+
+// src/lib/output.ts
+var noColor = process.env.NO_COLOR !== void 0 || process.argv.includes("--no-color");
+function color(code, text) {
+  if (noColor) return text;
+  return `\x1B[${code}m${text}\x1B[0m`;
+}
+var green = (t) => color("32", t);
+var red = (t) => color("31", t);
+var blue = (t) => color("34", t);
+var bold = (t) => color("1", t);
+function info(msg) {
+  console.error(`${blue("\u2192")} ${msg}`);
+}
+function ok(msg) {
+  console.error(`${green("\u2713")} ${msg}`);
+}
+function warn(msg) {
+  console.error(`${red("!")} ${msg}`);
+}
+function error(msg) {
+  console.error(`${red("\u2717")} ${msg}`);
+}
+
+// src/commands/init.ts
+function prompt(question, defaultValue) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stderr
+  });
+  const suffix = defaultValue ? ` (${defaultValue})` : "";
+  return new Promise((resolve2) => {
+    rl.question(`${question}${suffix}: `, (answer) => {
+      rl.close();
+      resolve2(answer.trim() || defaultValue || "");
+    });
+  });
+}
+async function promptChoice(question, choices) {
+  console.error("");
+  console.error(question);
+  for (const choice of choices) {
+    console.error(`  ${choice.key}) ${choice.label}`);
+  }
+  console.error("");
+  const answer = await prompt("Choice");
+  const match = choices.find((c) => c.key === answer);
+  return match ? match.key : choices[0].key;
+}
+var initCommand = new Command("init").description("Scaffold Lytos in your project").option("--name <name>", "Project name").option(
+  "--tool <tool>",
+  "AI tool to configure (claude, cursor, none)",
+  ""
+).option("--yes", "Skip prompts, use defaults", false).option("--force", "Override existing .lytos/ directory", false).option("--dry-run", "Show what would be created without creating", false).action(async (opts) => {
+  const cwd = process.cwd();
+  const lytosDir = resolve(cwd, ".lytos");
+  if (existsSync3(lytosDir) && !opts.force) {
+    error(
+      ".lytos/ already exists. Use --force to override."
+    );
+    process.exit(2);
+  }
+  info("Detecting project stack...");
+  const stack = detectStack(cwd);
+  if (stack.language) {
+    ok(`Detected: ${stack.language}${stack.framework ? ` + ${stack.framework}` : ""}${stack.tests ? ` + ${stack.tests}` : ""}`);
+  } else {
+    info("No known stack detected \u2014 you can fill it in manually.");
+  }
+  let projectName = opts.name;
+  if (!projectName && !opts.yes) {
+    projectName = await prompt(
+      "Project name",
+      basename(cwd)
+    );
+  }
+  projectName = projectName || basename(cwd);
+  let tool = opts.tool;
+  if (!tool && !opts.yes) {
+    const choice = await promptChoice("Which AI tool do you use?", [
+      { key: "1", label: "Claude Code" },
+      { key: "2", label: "Cursor" },
+      { key: "3", label: "Other / None" }
+    ]);
+    tool = choice === "1" ? "claude" : choice === "2" ? "cursor" : "none";
+  }
+  tool = tool || "none";
+  if (opts.dryRun) {
+    console.error("");
+    info(`${bold("Dry run")} \u2014 nothing will be created.`);
+  }
+  console.error("");
+  info(`Installing Lytos in .lytos/...`);
+  console.error("");
+  const result = await scaffold({
+    projectName,
+    tool,
+    stack,
+    cwd,
+    dryRun: opts.dryRun
+  });
+  for (const w of result.warnings) {
+    warn(w);
+  }
+  ok(`${result.filesCreated.length} files created`);
+  console.error("");
+  console.error(bold(green("Lytos is installed.")));
+  console.error("");
+  console.error("  Next step \u2014 open your AI tool and say:");
+  console.error("");
+  console.error(
+    `  ${bold('"Help me configure Lytos for this project."')}`
+  );
+  console.error("");
+  console.error(
+    "  The AI will read the briefing, understand the method, and ask"
+  );
+  console.error(
+    "  you the right questions to fill your manifest."
+  );
+  console.error("");
+  console.error("  Installed structure:");
+  console.error("  .lytos/");
+  console.error("  \u251C\u2500\u2500 LYTOS.md              <- AI briefing");
+  console.error(
+    "  \u251C\u2500\u2500 manifest.md           <- fill with your AI's help"
+  );
+  console.error("  \u251C\u2500\u2500 memory/");
+  console.error("  \u2502   \u251C\u2500\u2500 MEMORY.md");
+  console.error(
+    "  \u2502   \u2514\u2500\u2500 cortex/           <- will fill up as you work"
+  );
+  console.error("  \u251C\u2500\u2500 skills/               <- 9 operational skills");
+  console.error("  \u251C\u2500\u2500 rules/                <- quality criteria");
+  console.error("  \u251C\u2500\u2500 issue-board/          <- Kanban board");
+  console.error("  \u2514\u2500\u2500 templates/            <- sprint template");
+  console.error("");
+  console.error(
+    `  Documentation: https://github.com/getlytos/lytos-method`
+  );
+  console.error("");
+});
+
+// src/commands/board.ts
+import { Command as Command2 } from "commander";
+import { existsSync as existsSync5, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+
+// src/lib/board-generator.ts
+import { readdirSync, readFileSync as readFileSync2, existsSync as existsSync4 } from "fs";
+import { join as join3 } from "path";
+
+// src/lib/frontmatter.ts
+function parseFrontmatter(content) {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!match) return null;
+  const frontmatter = {};
+  for (const line of match[1].trim().split("\n")) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) continue;
+    const key = line.slice(0, colonIndex).trim();
+    let value = line.slice(colonIndex + 1).trim();
+    value = value.replace(/^["']|["']$/g, "");
+    if (value.startsWith("[") && value.endsWith("]")) {
+      const items = value.slice(1, -1).split(",").map((v) => v.trim().replace(/^["']|["']$/g, "")).filter((v) => v.length > 0);
+      frontmatter[key] = items;
+    } else {
+      frontmatter[key] = value;
+    }
+  }
+  return frontmatter;
+}
+
+// src/lib/board-generator.ts
+var STATUS_FOLDERS = [
+  "0-icebox",
+  "1-backlog",
+  "2-sprint",
+  "3-in-progress",
+  "4-review",
+  "5-done"
+];
+var STATUS_LABELS = {
+  "0-icebox": "ideas",
+  "1-backlog": "prioritized",
+  "2-sprint": "committed",
+  "3-in-progress": "in dev",
+  "4-review": "review/test",
+  "5-done": "completed"
+};
+function collectIssues(boardDir) {
+  const issues = [];
+  const warnings = [];
+  let maxNum = 0;
+  for (const folder of STATUS_FOLDERS) {
+    const folderPath = join3(boardDir, folder);
+    if (!existsSync4(folderPath)) continue;
+    const files = readdirSync(folderPath).filter((f) => f.startsWith("ISS-") && f.endsWith(".md")).sort();
+    for (const file of files) {
+      const content = readFileSync2(join3(folderPath, file), "utf-8");
+      const fm = parseFrontmatter(content);
+      if (!fm) {
+        warnings.push(`${folder}/${file}: no YAML frontmatter found`);
+        continue;
+      }
+      const fmStatus = typeof fm.status === "string" ? fm.status : "";
+      if (fmStatus && fmStatus !== folder) {
+        warnings.push(
+          `${folder}/${file}: folder is ${folder} but frontmatter says status: ${fmStatus}`
+        );
+      }
+      issues.push({
+        frontmatter: fm,
+        filename: file,
+        folder,
+        status: fmStatus || folder
+      });
+      const numMatch = file.match(/ISS-(\d+)/);
+      if (numMatch) {
+        maxNum = Math.max(maxNum, parseInt(numMatch[1], 10));
+      }
+    }
+  }
+  const nextNumber = `ISS-${String(maxNum + 1).padStart(4, "0")}`;
+  return { issues, warnings, nextNumber };
+}
+function generateBoardMarkdown(data) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const lines = [];
+  lines.push("# Issue Board");
+  lines.push("");
+  lines.push(
+    "> This file is generated by `lytos board`. The source of truth is the YAML frontmatter of each issue."
+  );
+  lines.push(">");
+  lines.push(`> **Last generated**: ${today}`);
+  lines.push(`> **Next number**: ${data.nextNumber}`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## Issue index");
+  lines.push("");
+  for (const folder of STATUS_FOLDERS) {
+    const label = STATUS_LABELS[folder];
+    lines.push(`### ${folder} (${label})`);
+    lines.push("");
+    const folderIssues = data.issues.filter((i) => i.status === folder);
+    if (folderIssues.length === 0) {
+      lines.push("_No issues._");
+      lines.push("");
+      continue;
+    }
+    if (folder === "5-done") {
+      lines.push("| # | Title | Completed |");
+      lines.push("|---|-------|-----------|");
+      for (const issue of folderIssues) {
+        const id = issue.frontmatter.id || "?";
+        const title = issue.frontmatter.title || "?";
+        const updated = issue.frontmatter.updated || "?";
+        const relPath = `${issue.folder}/${issue.filename}`;
+        lines.push(`| [${id}](${relPath}) | ${title} | ${updated} |`);
+      }
+    } else {
+      const hasDeps = folderIssues.some((i) => {
+        const deps = i.frontmatter.depends;
+        return Array.isArray(deps) ? deps.length > 0 : !!deps;
+      });
+      if (hasDeps) {
+        lines.push("| # | Title | Priority | Effort | Depends |");
+        lines.push("|---|-------|----------|--------|---------|");
+      } else {
+        lines.push("| # | Title | Priority | Effort |");
+        lines.push("|---|-------|----------|--------|");
+      }
+      for (const issue of folderIssues) {
+        const id = issue.frontmatter.id || "?";
+        const title = issue.frontmatter.title || "?";
+        const priority = issue.frontmatter.priority || "?";
+        const effort = issue.frontmatter.effort || "?";
+        const relPath = `${issue.folder}/${issue.filename}`;
+        if (hasDeps) {
+          const deps = issue.frontmatter.depends;
+          const depsStr = Array.isArray(deps) && deps.length > 0 ? deps.join(", ") : "\u2014";
+          lines.push(
+            `| [${id}](${relPath}) | ${title} | ${priority} | ${effort} | ${depsStr} |`
+          );
+        } else {
+          lines.push(
+            `| [${id}](${relPath}) | ${title} | ${priority} | ${effort} |`
+          );
+        }
+      }
+    }
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push(
+    "*Generated by `lytos board` \u2014 the YAML frontmatter is the source of truth.*"
+  );
+  lines.push("");
+  return lines.join("\n");
+}
+function boardToJson(data) {
+  return {
+    generated: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    nextNumber: data.nextNumber,
+    warnings: data.warnings,
+    columns: STATUS_FOLDERS.map((folder) => ({
+      folder,
+      label: STATUS_LABELS[folder],
+      issues: data.issues.filter((i) => i.status === folder).map((i) => ({
+        id: i.frontmatter.id,
+        title: i.frontmatter.title,
+        priority: i.frontmatter.priority,
+        effort: i.frontmatter.effort,
+        complexity: i.frontmatter.complexity,
+        depends: i.frontmatter.depends,
+        status: i.status,
+        file: `${i.folder}/${i.filename}`
+      }))
+    }))
+  };
+}
+
+// src/commands/board.ts
+function findBoardDir(cwd) {
+  const candidates = [
+    join4(cwd, ".lytos", "issue-board"),
+    join4(cwd, "issue-board")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync5(candidate)) return candidate;
+  }
+  return null;
+}
+var boardCommand = new Command2("board").description("Regenerate BOARD.md from issue frontmatter").option(
+  "--check",
+  "Check if BOARD.md is up to date (exit 1 if not)",
+  false
+).option("--json", "Output board data as JSON", false).action((opts) => {
+  const cwd = process.cwd();
+  const boardDir = findBoardDir(cwd);
+  if (!boardDir) {
+    error(
+      "No issue-board/ directory found. Run `lytos init` first."
+    );
+    process.exit(2);
+  }
+  const data = collectIssues(boardDir);
+  for (const w of data.warnings) {
+    warn(w);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(boardToJson(data), null, 2));
+    return;
+  }
+  const newContent = generateBoardMarkdown(data);
+  if (opts.check) {
+    const boardPath2 = join4(boardDir, "BOARD.md");
+    if (!existsSync5(boardPath2)) {
+      error("BOARD.md does not exist.");
+      process.exit(1);
+    }
+    const existing = readFileSync3(boardPath2, "utf-8");
+    const normalize = (s) => s.replace(/\*\*Last generated\*\*:.*/, "").trim();
+    if (normalize(existing) === normalize(newContent)) {
+      ok("BOARD.md is up to date.");
+      return;
+    } else {
+      error(
+        "BOARD.md is outdated. Run `lytos board` to regenerate."
+      );
+      process.exit(1);
+    }
+  }
+  const boardPath = join4(boardDir, "BOARD.md");
+  writeFileSync2(boardPath, newContent, "utf-8");
+  ok(
+    `BOARD.md generated: ${data.issues.length} issues found`
+  );
+});
+
+// src/cli.ts
+var program = new Command3();
+program.name("lytos").description(
+  "CLI tool for Lytos \u2014 a human-first method for working with AI agents"
+).version("0.1.1");
+program.addCommand(initCommand);
+program.addCommand(boardCommand);
+program.parse();

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "lytos-cli",
+  "version": "0.2.0",
+  "description": "CLI tool for Lytos — a human-first method for working with AI agents",
+  "type": "module",
+  "bin": {
+    "lytos": "dist/cli.js",
+    "lytos-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "pretest": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "format": "prettier --write 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "lytos",
+    "ai",
+    "agents",
+    "cli",
+    "scaffold",
+    "methodology",
+    "skills",
+    "memory",
+    "rules"
+  ],
+  "author": "Frederic Galliné <frederic@galline.fr> (https://ubeez.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getlytos/lytos-cli.git"
+  },
+  "homepage": "https://github.com/getlytos/lytos-method",
+  "bugs": {
+    "url": "https://github.com/getlytos/lytos-cli/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^20.14.0",
+    "eslint": "^9.5.0",
+    "prettier": "^3.3.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.58.1",
+    "vitest": "^2.0.0"
+  }
+}