antikit 1.9.1 → 1.10.1

package/README.md

@@ -167,6 +167,27 @@ dependencies:
 ...
 ```
 
+---
+
+### 🔐 Authentication (Optional)
+
+To increase GitHub API rate limits (avoiding "API rate limit exceeded" errors), you can configure a Personal Access Token.
+
+```bash
+# Set token
+antikit config set-token ghp_xxxxxxxxxxxx
+
+# Check config
+antikit config list
+# or
+antikit config ls
+
+# Remove token
+antikit config remove-token
+```
+
+---
+
 ## Requirements
 
 - Node.js >= 18.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antikit",
-  "version": "1.9.1",
+  "version": "1.10.1",
   "description": "CLI tool to manage AI agent skills from Anti Gravity skills repository",
   "type": "module",
   "main": "src/index.js",

package/src/commands/config.js

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+import {
+  setToken,
+  getToken,
+  removeToken,
+  getConfigPath,
+  loadConfig
+} from '../utils/configManager.js';
+
+/**
+ * List all configurations
+ */
+export function listConfig() {
+  const config = loadConfig();
+  console.log(chalk.bold('\nCurrent Configuration:'));
+  console.log(chalk.dim('─'.repeat(40)));
+
+  if (config.githubToken) {
+    console.log(`GitHub Token: ${chalk.green('********' + config.githubToken.slice(-4))}`);
+  } else {
+    console.log(`GitHub Token: ${chalk.dim('(not set)')}`);
+  }
+
+  // List other configs if any...
+
+  console.log();
+  console.log(chalk.dim(`Config file: ${getConfigPath()}`));
+  console.log();
+}
+
+/**
+ * Set GitHub Token
+ */
+export function setGitHubToken(token) {
+  if (!token) {
+    console.error(chalk.red('Error: Token is required'));
+    process.exit(1);
+  }
+
+  setToken(token);
+  console.log(chalk.green('\n✓ GitHub Token saved successfully.'));
+  console.log(chalk.dim('API rate limit increased.'));
+  console.log();
+}
+
+/**
+ * Remove GitHub Token
+ */
+export function removeGitHubToken() {
+  removeToken();
+  console.log(chalk.green('\n✓ GitHub Token removed.'));
+  console.log();
+}

package/src/commands/list.js

@@ -47,10 +47,22 @@ export async function listRemoteSkills(options) {
     const infoSpinner = ora('Fetching skill info...').start();
     const skillsWithInfo = await Promise.all(
       skills.map(async skill => {
-        // Pass basePath to fetch correct SKILL.md location
-        const info = await fetchSkillInfo(skill.name, skill.owner, skill.repo, skill.basePath);
-        const description = info ? info.description : null;
-        const remoteVersion = info ? info.version : '0.0.0';
+        let description = skill.description;
+        let remoteVersion = skill.version || '0.0.0';
+
+        // Only fetch info if not already fetched (REST fallback)
+        if (description === undefined || description === null) {
+          // Pass basePath and branch to fetch correct SKILL.md location optimized
+          const info = await fetchSkillInfo(
+            skill.name,
+            skill.owner,
+            skill.repo,
+            skill.basePath,
+            skill.branch
+          );
+          description = info ? info.description : null;
+          remoteVersion = info ? info.version : '0.0.0';
+        }
 
         const installed = skillExists(skill.name);
         let updateAvailable = false;

package/src/index.js

@@ -10,6 +10,7 @@ import { removeSkill } from './commands/remove.js';
 import { updateCli } from './commands/update.js';
 import { upgradeSkills } from './commands/upgrade.js';
 import { listSources, addNewSource, removeExistingSource, setDefault } from './commands/source.js';
+import { listConfig, setGitHubToken, removeGitHubToken } from './commands/config.js';
 import { checkForUpdates } from './utils/updateNotifier.js';
 import { setupCompletion } from './utils/completion.js';
 
@@ -110,4 +111,19 @@ sourceCmd
 
 sourceCmd.command('default <name>').description('Set default source').action(setDefault);
 
+// Config management commands
+const configCmd = program.command('config').description('Manage CLI configuration');
+
+configCmd.command('list').alias('ls').description('List current configuration').action(listConfig);
+
+configCmd
+  .command('set-token <token>')
+  .description('Set GitHub Personal Access Token')
+  .action(setGitHubToken);
+
+configCmd
+  .command('remove-token')
+  .description('Remove GitHub Personal Access Token')
+  .action(removeGitHubToken);
+
 program.parse();

package/src/utils/configManager.js

@@ -163,6 +163,32 @@ export function setDefaultSource(name) {
   return config.sources;
 }
 
+/**
+ * Set GitHub Token
+ */
+export function setToken(token) {
+  const config = loadConfig();
+  config.githubToken = token;
+  saveConfig(config);
+}
+
+/**
+ * Get GitHub Token
+ */
+export function getToken() {
+  const config = loadConfig();
+  return config.githubToken;
+}
+
+/**
+ * Remove GitHub Token
+ */
+export function removeToken() {
+  const config = loadConfig();
+  delete config.githubToken;
+  saveConfig(config);
+}
+
 /**
  * Get config file path (for display)
  */

package/src/utils/github.js

@@ -1,4 +1,4 @@
-import { getSources } from './configManager.js';
+import { getSources, getToken } from './configManager.js';
 
 const GITHUB_API = 'https://api.github.com';
 
@@ -7,21 +7,126 @@ function getHeaders() {
     Accept: 'application/vnd.github.v3+json',
     'User-Agent': 'antikit-cli'
   };
-  const token = process.env.ANTIKIT_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
+  const token = getToken() || process.env.ANTIKIT_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
   if (token) {
     headers.Authorization = `token ${token}`;
   }
   return headers;
 }
 
+/**
+ * Fetch skills using GraphQL (Optimized: 1 request per source)
+ */
+async function fetchSkillsViaGraphQL(source, token) {
+  const query = `
+    query ($owner: String!, $repo: String!, $expression: String!) {
+      repository(owner: $owner, name: $repo) {
+        object(expression: $expression) {
+          ... on Tree {
+            entries {
+              name
+              type
+              object {
+                ... on Tree {
+                  file: entries(name: "SKILL.md") {
+                    object {
+                      ... on Blob {
+                        text
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+    `;
+
+  const branch = source.branch || 'main'; // This logic might need verifying branch exists, but usually main/master
+  // Correct expression for path. If path is provided, it's "branch:path", else just "branch:"
+  const expression = source.path ? `${branch}:${source.path}` : `${branch}:`;
+
+  try {
+    const response = await fetch('https://api.github.com/graphql', {
+      method: 'POST',
+      headers: {
+        Authorization: `token ${token}`,
+        'User-Agent': 'antikit-cli'
+      },
+      body: JSON.stringify({
+        query,
+        variables: {
+          owner: source.owner,
+          repo: source.repo,
+          expression
+        }
+      })
+    });
+
+    const { data, errors } = await response.json();
+
+    if (errors || !data || !data.repository || !data.repository.object) {
+      return null; // Fallback to REST
+    }
+
+    const entries = data.repository.object.entries || [];
+
+    return entries
+      .filter(item => item.type === 'tree' && !item.name.startsWith('.'))
+      .map(item => {
+        let description = null;
+        let version = '0.0.0';
+
+        // Attempt to parse SKILL.md content if it exists
+        const skillFile = item.object.file && item.object.file[0];
+        if (skillFile && skillFile.object && skillFile.object.text) {
+          const content = skillFile.object.text;
+          const match = content.match(/^---\n([\s\S]*?)\n---/);
+          if (match) {
+            const frontmatter = match[1];
+            const descMatch = frontmatter.match(/description:\s*(.+)/);
+            const verMatch = frontmatter.match(/version:\s*(.+)/);
+            if (descMatch) description = descMatch[1].trim();
+            if (verMatch) version = verMatch[1].trim();
+          }
+        }
+
+        return {
+          name: item.name,
+          url: `https://github.com/${source.owner}/${source.repo}/tree/${branch}/${source.path ? source.path + '/' : ''}${item.name}`,
+          path: source.path ? `${source.path}/${item.name}` : item.name,
+          source: source.name,
+          owner: source.owner,
+          repo: source.repo,
+          basePath: source.path,
+          description, // Pre-fetched!
+          version // Pre-fetched!
+        };
+      });
+  } catch (e) {
+    return null; // Fallback
+  }
+}
+
 /**
  * Fetch list of skills from a specific source
  */
 async function fetchSkillsFromSource(source) {
+  // Try GraphQL first if token exists (Much faster)
+  const token = getToken() || process.env.ANTIKIT_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
+  if (token) {
+    const gqlResult = await fetchSkillsViaGraphQL(source, token);
+    if (gqlResult) return gqlResult;
+  }
+
+  // Fallback to REST API
   let url = `${GITHUB_API}/repos/${source.owner}/${source.repo}/contents`;
   if (source.path) {
     url += `/${source.path}`;
   }
+  // ... rest of function
 
   const response = await fetch(url, {
     headers: getHeaders()
@@ -61,36 +166,19 @@ async function fetchSkillsFromSource(source) {
       source: source.name,
       owner: source.owner,
       repo: source.repo,
+      branch: source.branch || 'main',
       basePath: source.path // Keep track of base path
     }));
 
   return skills;
 }
 
-/**
- * Fetch list of skills from all configured sources
- */
-export async function fetchRemoteSkills(sourceName = null) {
-  const sources = getSources();
-
-  // Filter by source name if provided
-  const targetSources = sourceName ? sources.filter(s => s.name === sourceName) : sources;
-
-  if (targetSources.length === 0) {
-    throw new Error(`Source "${sourceName}" not found.`);
-  }
-
-  // Fetch from all sources in parallel
-  const results = await Promise.all(targetSources.map(source => fetchSkillsFromSource(source)));
-
-  // Flatten and return all skills
-  return results.flat();
-}
+// ... (fetchRemoteSkills remains same)
 
 /**
  * Fetch SKILL.md content for a specific skill
  */
-export async function fetchSkillInfo(skillName, owner, repo, path = null) {
+export async function fetchSkillInfo(skillName, owner, repo, path = null, branch = null) {
   // If owner/repo not provided, search in all sources
   if (!owner || !repo) {
     const skills = await fetchRemoteSkills();
@@ -99,24 +187,46 @@ export async function fetchSkillInfo(skillName, owner, repo, path = null) {
     owner = skill.owner;
     repo = skill.repo;
     path = skill.basePath;
+    branch = skill.branch;
   }
 
-  let url = `${GITHUB_API}/repos/${owner}/${repo}/contents`;
-  if (path) {
-    url += `/${path}`;
+  let content = null;
+
+  // Optimized: Use Raw URL if branch is known (avoids API rate limit)
+  if (branch) {
+    let rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}`;
+    if (path) rawUrl += `/${path}`;
+    rawUrl += `/${skillName}/SKILL.md`;
+
+    try {
+      const res = await fetch(rawUrl);
+      if (res.ok) {
+        content = await res.text();
+      }
+    } catch (e) {
+      // Ignore fetch error, fallback to API
+    }
   }
-  url += `/${skillName}/SKILL.md`;
 
-  const response = await fetch(url, {
-    headers: getHeaders()
-  });
+  // Fallback: Use API (Counts against rate limit, but works if branch is wrong/private repo needs Auth)
+  if (!content) {
+    let url = `${GITHUB_API}/repos/${owner}/${repo}/contents`;
+    if (path) {
+      url += `/${path}`;
+    }
+    url += `/${skillName}/SKILL.md`;
 
-  if (!response.ok) {
-    return null;
-  }
+    const response = await fetch(url, {
+      headers: getHeaders()
+    });
 
-  const data = await response.json();
-  const content = Buffer.from(data.content, 'base64').toString('utf-8');
+    if (!response.ok) {
+      return null;
+    }
+
+    const data = await response.json();
+    content = Buffer.from(data.content, 'base64').toString('utf-8');
+  }
 
   // Extract info from YAML frontmatter
   const match = content.match(/^---\n([\s\S]*?)\n---/);