hanka-cli 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# Hanka CLI
+
+CLI tool for fetching and managing AI agent skills from Hanka instances.
+
+## Installation
+
+```bash
+npx hanka --help
+```
+
+## Commands
+
+### `hanka login`
+
+Authenticate with GitHub using Device Flow. Required for accessing private repos.
+
+```bash
+npx hanka login
+```
+
+### `hanka logout`
+
+Remove stored GitHub credentials.
+
+```bash
+npx hanka logout
+```
+
+### `hanka whoami`
+
+Show currently authenticated user.
+
+```bash
+npx hanka whoami
+```
+
+### `hanka add <instance> <username/slug>`
+
+Fetch a public skill from a Hanka instance.
+
+```bash
+npx hanka add https://hanka.example.com johndoe/docx-writer
+```
+
+Options:
+- `-p, --path <dir>` - Output directory (default: current directory)
+- `--stdout` - Print to stdout instead of writing a file
+- `--repo <repo>` - GitHub repo name (default: hanka-skills)
+
+### `hanka get <username/repo:slug>`
+
+Fetch a skill directly from GitHub (supports private repos, requires login).
+
+```bash
+npx hanka get johndoe/hanka-skills:docx-writer
+```
+
+Options:
+- `-p, --path <dir>` - Output directory (default: current directory)
+- `--stdout` - Print to stdout instead of writing a file
+
+### `hanka list <instance> <username>`
+
+List public skills from a Hanka instance.
+
+```bash
+npx hanka list https://hanka.example.com johndoe
+```
+
+Options:
+- `--repo <repo>` - GitHub repo name (default: hanka-skills)
+
+## Environment Variables
+
+- `HANKA_CLIENT_ID` - GitHub OAuth App Client ID (optional, uses embedded default)

package/dist/index.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import Conf from 'conf';
+import { Octokit } from '@octokit/rest';
+import { writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+const GITHUB_CLIENT_ID = process.env.HANKA_CLIENT_ID ?? 'YOUR_GITHUB_OAUTH_APP_CLIENT_ID';
+const config = new Conf({ projectName: 'hanka' });
+const program = new Command();
+program
+    .name('hanka')
+    .version('0.1.0')
+    .description('Hanka CLI — manage and fetch AI agent skills');
+program
+    .command('login')
+    .description('Authenticate with GitHub (enables private repo access)')
+    .action(async () => {
+    const spinner = ora('Requesting device code...').start();
+    const deviceRes = await fetch('https://github.com/login/device/code', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({ client_id: GITHUB_CLIENT_ID, scope: 'repo' }),
+    });
+    const deviceData = await deviceRes.json();
+    spinner.stop();
+    console.log();
+    console.log(chalk.bold('Open this URL in your browser:'));
+    console.log(chalk.cyan('  ' + deviceData.verification_uri));
+    console.log();
+    console.log(chalk.bold('Enter this code when prompted:'));
+    console.log(chalk.yellow('  ' + deviceData.user_code));
+    console.log();
+    const pollSpinner = ora('Waiting for authorization...').start();
+    const deadline = Date.now() + deviceData.expires_in * 1000;
+    while (Date.now() < deadline) {
+        await new Promise(r => setTimeout(r, (deviceData.interval + 1) * 1000));
+        const pollRes = await fetch('https://github.com/login/oauth/access_token', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            body: JSON.stringify({
+                client_id: GITHUB_CLIENT_ID,
+                device_code: deviceData.device_code,
+                grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+            }),
+        });
+        const pollData = await pollRes.json();
+        if (pollData.access_token) {
+            const userRes = await fetch('https://api.github.com/user', {
+                headers: { Authorization: `Bearer ${pollData.access_token}` },
+            });
+            const { login } = await userRes.json();
+            config.set('token', pollData.access_token);
+            config.set('username', login);
+            pollSpinner.succeed(chalk.green(`Logged in as @${login}`));
+            return;
+        }
+        if (pollData.error && pollData.error !== 'authorization_pending' && pollData.error !== 'slow_down') {
+            pollSpinner.fail(`Authentication failed: ${pollData.error}`);
+            process.exit(1);
+        }
+    }
+    pollSpinner.fail('Timed out waiting for authorization');
+    process.exit(1);
+});
+program
+    .command('logout')
+    .description('Remove stored GitHub credentials')
+    .action(() => {
+    config.delete('token');
+    config.delete('username');
+    console.log(chalk.green('Logged out successfully'));
+});
+program
+    .command('whoami')
+    .description('Show currently authenticated GitHub user')
+    .action(() => {
+    const username = config.get('username');
+    if (username) {
+        console.log(chalk.green(`Logged in as @${username}`));
+    }
+    else {
+        console.log(chalk.yellow('Not logged in. Run: npx hanka login'));
+    }
+});
+program
+    .command('add <instance> <target>')
+    .description('Fetch a public skill from a Hanka instance')
+    .option('-p, --path <dir>', 'Output directory (default: current directory)')
+    .option('--stdout', 'Print to stdout instead of writing a file')
+    .option('--repo <repo>', 'GitHub repo name (default: hanka-skills)', 'hanka-skills')
+    .action(async (instance, target, opts) => {
+    const parts = target.split('/');
+    if (parts.length !== 2) {
+        console.error(chalk.red('Format: hanka add <instance-url> <username/slug>'));
+        process.exit(1);
+    }
+    const [username, slug] = parts;
+    const cleanInstance = instance.replace(/\/$/, '');
+    const spinner = ora(`Fetching ${chalk.cyan(slug)} from ${cleanInstance}...`).start();
+    const res = await fetch(`${cleanInstance}/api/public/${username}/${slug}?repo=${opts.repo}`);
+    if (!res.ok) {
+        spinner.fail(`Skill not found or not public (${res.status})`);
+        process.exit(1);
+    }
+    const data = await res.json();
+    spinner.succeed(`Fetched: ${chalk.bold(data.name)}`);
+    if (opts.stdout) {
+        process.stdout.write(data.rawMarkdown);
+        return;
+    }
+    const outDir = opts.path ?? '.';
+    mkdirSync(outDir, { recursive: true });
+    const outPath = join(outDir, `${slug}.md`);
+    writeFileSync(outPath, data.rawMarkdown, 'utf-8');
+    console.log(chalk.green(`✓ Saved to ${outPath}`));
+});
+program
+    .command('get <target>')
+    .description('Fetch a skill directly from GitHub (supports private repos, requires login)')
+    .option('-p, --path <dir>', 'Output directory (default: current directory)')
+    .option('--stdout', 'Print to stdout instead of writing a file')
+    .action(async (target, opts) => {
+    const token = config.get('token');
+    if (!token) {
+        console.error(chalk.red('Not logged in. Run: npx hanka login'));
+        process.exit(1);
+    }
+    const match = target.match(/^([^/]+)\/([^:]+):(.+)$/);
+    if (!match) {
+        console.error(chalk.red('Format: hanka get username/repo:slug'));
+        console.error(chalk.gray('Example: hanka get johndoe/hanka-skills:docx-writer'));
+        process.exit(1);
+    }
+    const [, owner, repo, slug] = match;
+    const spinner = ora(`Fetching ${chalk.cyan(slug)} from ${owner}/${repo}...`).start();
+    const octokit = new Octokit({ auth: token });
+    let filePath;
+    try {
+        const { data } = await octokit.rest.repos.getContent({ owner, repo, path: 'index.json' });
+        if (!('content' in data))
+            throw new Error('index.json is not a file');
+        const index = JSON.parse(Buffer.from(data.content, 'base64').toString('utf-8'));
+        const entry = index.find(s => s.slug === slug);
+        if (!entry) {
+            spinner.fail(`Skill "${slug}" not found in index.json`);
+            process.exit(1);
+        }
+        filePath = entry.filePath;
+    }
+    catch (err) {
+        if (err.status === 404) {
+            spinner.fail(`Repo ${owner}/${repo} not found or index.json missing`);
+        }
+        else if (err.status === 401) {
+            spinner.fail('Token expired or invalid. Run: npx hanka login');
+        }
+        else {
+            spinner.fail(`Error: ${err.message}`);
+        }
+        process.exit(1);
+    }
+    const { data } = await octokit.rest.repos.getContent({ owner, repo, path: filePath });
+    if (!('content' in data)) {
+        spinner.fail('Could not read skill file');
+        process.exit(1);
+    }
+    const rawMarkdown = Buffer.from(data.content, 'base64').toString('utf-8');
+    spinner.succeed(`Fetched: ${chalk.bold(slug)}`);
+    if (opts.stdout) {
+        process.stdout.write(rawMarkdown);
+        return;
+    }
+    const outDir = opts.path ?? '.';
+    mkdirSync(outDir, { recursive: true });
+    const outPath = join(outDir, `${slug}.md`);
+    writeFileSync(outPath, rawMarkdown, 'utf-8');
+    console.log(chalk.green(`✓ Saved to ${outPath}`));
+});
+program
+    .command('list <instance> <username>')
+    .description('List public skills from a Hanka instance')
+    .option('--repo <repo>', 'GitHub repo name', 'hanka-skills')
+    .action(async (instance, username, opts) => {
+    const cleanInstance = instance.replace(/\/$/, '');
+    const spinner = ora('Fetching skill list...').start();
+    const res = await fetch(`${cleanInstance}/api/public/${username}?repo=${opts.repo}`);
+    if (!res.ok) {
+        spinner.fail(`Could not fetch skills for @${username}`);
+        process.exit(1);
+    }
+    const skills = await res.json();
+    spinner.stop();
+    if (skills.length === 0) {
+        console.log(chalk.yellow(`No public skills found for @${username}`));
+        return;
+    }
+    console.log(chalk.bold(`\n${username}'s public skills (${skills.length}):\n`));
+    skills.forEach(s => {
+        const tags = s.tags?.map(t => chalk.gray(`#${t}`)).join(' ') ?? '';
+        console.log(`  ${chalk.cyan(s.slug.padEnd(28))} ${s.name.padEnd(32)} ${tags}`);
+    });
+    console.log();
+    console.log(chalk.gray(`To fetch a skill: npx hanka add ${cleanInstance} ${username}/<slug>`));
+    console.log();
+});
+program.parse();

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "hanka-cli",
+  "version": "0.1.0",
+  "description": "CLI for Hanka — fetch and manage agent skills",
+  "bin": { "hanka": "./dist/index.js" },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "conf": "^13.0.0",
+    "@octokit/rest": "^21.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "type": "module",
+  "engines": { "node": ">=18" }
+}

package/src/index.ts

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+import { Command } from 'commander'
+import chalk from 'chalk'
+import ora from 'ora'
+import Conf from 'conf'
+import { Octokit } from '@octokit/rest'
+import { writeFileSync, mkdirSync } from 'fs'
+import { join } from 'path'
+
+const GITHUB_CLIENT_ID = process.env.HANKA_CLIENT_ID ?? 'YOUR_GITHUB_OAUTH_APP_CLIENT_ID'
+
+const config = new Conf<{ token?: string; username?: string }>({ projectName: 'hanka' })
+
+const program = new Command()
+program
+  .name('hanka')
+  .version('0.1.0')
+  .description('Hanka CLI — manage and fetch AI agent skills')
+
+program
+  .command('login')
+  .description('Authenticate with GitHub (enables private repo access)')
+  .action(async () => {
+    const spinner = ora('Requesting device code...').start()
+
+    const deviceRes = await fetch('https://github.com/login/device/code', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+      body: JSON.stringify({ client_id: GITHUB_CLIENT_ID, scope: 'repo' }),
+    })
+    const deviceData = await deviceRes.json() as {
+      device_code: string
+      user_code: string
+      verification_uri: string
+      interval: number
+      expires_in: number
+    }
+    spinner.stop()
+
+    console.log()
+    console.log(chalk.bold('Open this URL in your browser:'))
+    console.log(chalk.cyan('  ' + deviceData.verification_uri))
+    console.log()
+    console.log(chalk.bold('Enter this code when prompted:'))
+    console.log(chalk.yellow('  ' + deviceData.user_code))
+    console.log()
+
+    const pollSpinner = ora('Waiting for authorization...').start()
+    const deadline = Date.now() + deviceData.expires_in * 1000
+
+    while (Date.now() < deadline) {
+      await new Promise(r => setTimeout(r, (deviceData.interval + 1) * 1000))
+
+      const pollRes = await fetch('https://github.com/login/oauth/access_token', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({
+          client_id: GITHUB_CLIENT_ID,
+          device_code: deviceData.device_code,
+          grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
+        }),
+      })
+      const pollData = await pollRes.json() as { access_token?: string; error?: string }
+
+      if (pollData.access_token) {
+        const userRes = await fetch('https://api.github.com/user', {
+          headers: { Authorization: `Bearer ${pollData.access_token}` },
+        })
+        const { login } = await userRes.json() as { login: string }
+
+        config.set('token', pollData.access_token)
+        config.set('username', login)
+        pollSpinner.succeed(chalk.green(`Logged in as @${login}`))
+        return
+      }
+
+      if (pollData.error && pollData.error !== 'authorization_pending' && pollData.error !== 'slow_down') {
+        pollSpinner.fail(`Authentication failed: ${pollData.error}`)
+        process.exit(1)
+      }
+    }
+
+    pollSpinner.fail('Timed out waiting for authorization')
+    process.exit(1)
+  })
+
+program
+  .command('logout')
+  .description('Remove stored GitHub credentials')
+  .action(() => {
+    config.delete('token')
+    config.delete('username')
+    console.log(chalk.green('Logged out successfully'))
+  })
+
+program
+  .command('whoami')
+  .description('Show currently authenticated GitHub user')
+  .action(() => {
+    const username = config.get('username')
+    if (username) {
+      console.log(chalk.green(`Logged in as @${username}`))
+    } else {
+      console.log(chalk.yellow('Not logged in. Run: npx hanka login'))
+    }
+  })
+
+program
+  .command('add <instance> <target>')
+  .description('Fetch a public skill from a Hanka instance')
+  .option('-p, --path <dir>', 'Output directory (default: current directory)')
+  .option('--stdout', 'Print to stdout instead of writing a file')
+  .option('--repo <repo>', 'GitHub repo name (default: hanka-skills)', 'hanka-skills')
+  .action(async (instance: string, target: string, opts: { path?: string; stdout?: boolean; repo: string }) => {
+    const parts = target.split('/')
+    if (parts.length !== 2) {
+      console.error(chalk.red('Format: hanka add <instance-url> <username/slug>'))
+      process.exit(1)
+    }
+    const [username, slug] = parts
+    const cleanInstance = instance.replace(/\/$/, '')
+
+    const spinner = ora(`Fetching ${chalk.cyan(slug)} from ${cleanInstance}...`).start()
+
+    const res = await fetch(`${cleanInstance}/api/public/${username}/${slug}?repo=${opts.repo}`)
+
+    if (!res.ok) {
+      spinner.fail(`Skill not found or not public (${res.status})`)
+      process.exit(1)
+    }
+
+    const data = await res.json() as { rawMarkdown: string; name: string }
+    spinner.succeed(`Fetched: ${chalk.bold(data.name)}`)
+
+    if (opts.stdout) {
+      process.stdout.write(data.rawMarkdown)
+      return
+    }
+
+    const outDir = opts.path ?? '.'
+    mkdirSync(outDir, { recursive: true })
+    const outPath = join(outDir, `${slug}.md`)
+    writeFileSync(outPath, data.rawMarkdown, 'utf-8')
+    console.log(chalk.green(`✓ Saved to ${outPath}`))
+  })
+
+program
+  .command('get <target>')
+  .description('Fetch a skill directly from GitHub (supports private repos, requires login)')
+  .option('-p, --path <dir>', 'Output directory (default: current directory)')
+  .option('--stdout', 'Print to stdout instead of writing a file')
+  .action(async (target: string, opts: { path?: string; stdout?: boolean }) => {
+    const token = config.get('token')
+    if (!token) {
+      console.error(chalk.red('Not logged in. Run: npx hanka login'))
+      process.exit(1)
+    }
+
+    const match = target.match(/^([^/]+)\/([^:]+):(.+)$/)
+    if (!match) {
+      console.error(chalk.red('Format: hanka get username/repo:slug'))
+      console.error(chalk.gray('Example: hanka get johndoe/hanka-skills:docx-writer'))
+      process.exit(1)
+    }
+    const [, owner, repo, slug] = match
+
+    const spinner = ora(`Fetching ${chalk.cyan(slug)} from ${owner}/${repo}...`).start()
+    const octokit = new Octokit({ auth: token })
+
+    let filePath: string
+    try {
+      const { data } = await octokit.rest.repos.getContent({ owner, repo, path: 'index.json' })
+      if (!('content' in data)) throw new Error('index.json is not a file')
+      const index = JSON.parse(Buffer.from(data.content, 'base64').toString('utf-8')) as Array<{ slug: string; filePath: string }>
+      const entry = index.find(s => s.slug === slug)
+      if (!entry) {
+        spinner.fail(`Skill "${slug}" not found in index.json`)
+        process.exit(1)
+      }
+      filePath = entry.filePath
+    } catch (err: any) {
+      if (err.status === 404) {
+        spinner.fail(`Repo ${owner}/${repo} not found or index.json missing`)
+      } else if (err.status === 401) {
+        spinner.fail('Token expired or invalid. Run: npx hanka login')
+      } else {
+        spinner.fail(`Error: ${err.message}`)
+      }
+      process.exit(1)
+    }
+
+    const { data } = await octokit.rest.repos.getContent({ owner, repo, path: filePath })
+    if (!('content' in data)) {
+      spinner.fail('Could not read skill file')
+      process.exit(1)
+    }
+    const rawMarkdown = Buffer.from(data.content, 'base64').toString('utf-8')
+    spinner.succeed(`Fetched: ${chalk.bold(slug)}`)
+
+    if (opts.stdout) {
+      process.stdout.write(rawMarkdown)
+      return
+    }
+
+    const outDir = opts.path ?? '.'
+    mkdirSync(outDir, { recursive: true })
+    const outPath = join(outDir, `${slug}.md`)
+    writeFileSync(outPath, rawMarkdown, 'utf-8')
+    console.log(chalk.green(`✓ Saved to ${outPath}`))
+  })
+
+program
+  .command('list <instance> <username>')
+  .description('List public skills from a Hanka instance')
+  .option('--repo <repo>', 'GitHub repo name', 'hanka-skills')
+  .action(async (instance: string, username: string, opts: { repo: string }) => {
+    const cleanInstance = instance.replace(/\/$/, '')
+    const spinner = ora('Fetching skill list...').start()
+
+    const res = await fetch(`${cleanInstance}/api/public/${username}?repo=${opts.repo}`)
+    if (!res.ok) {
+      spinner.fail(`Could not fetch skills for @${username}`)
+      process.exit(1)
+    }
+
+    const skills = await res.json() as Array<{ slug: string; name: string; description?: string; tags?: string[] }>
+    spinner.stop()
+
+    if (skills.length === 0) {
+      console.log(chalk.yellow(`No public skills found for @${username}`))
+      return
+    }
+
+    console.log(chalk.bold(`\n${username}'s public skills (${skills.length}):\n`))
+    skills.forEach(s => {
+      const tags = s.tags?.map(t => chalk.gray(`#${t}`)).join(' ') ?? ''
+      console.log(`  ${chalk.cyan(s.slug.padEnd(28))} ${s.name.padEnd(32)} ${tags}`)
+    })
+    console.log()
+    console.log(chalk.gray(`To fetch a skill: npx hanka add ${cleanInstance} ${username}/<slug>`))
+    console.log()
+  })
+
+program.parse()

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}