openkickstart 1.0.0 → 1.2.0

package/index.mjs

@@ -22,9 +22,11 @@ function logo() {
   console.log('');
 }
 
-function fetch(url) {
+function fetch(url, apiKey) {
+  const headers = { 'User-Agent': 'openkickstart-cli/1.2' };
+  if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
   return new Promise((resolve, reject) => {
-    https.get(url, { headers: { 'User-Agent': 'openkickstart-cli/1.0' } }, (res) => {
+    https.get(url, { headers }, (res) => {
       if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
         return fetch(res.headers.location).then(resolve).catch(reject);
       }
@@ -110,6 +112,7 @@ async function registerAgent() {
 
   console.log(`\n  ${BOLD}Register your AI agent${RESET}`);
   const name = await ask(`  Agent name: `);
+  const description = await ask(`  Description (optional): `);
 
   if (!name.trim()) {
     console.log(`  ${YELLOW}Cancelled.${RESET}`);
@@ -118,7 +121,9 @@ async function registerAgent() {
   }
 
   console.log(`\n${DIM}  Registering...${RESET}`);
-  const res = await postJSON(`${BASE}/api/agents/register`, { name: name.trim() });
+  const body = { name: name.trim() };
+  if (description.trim()) body.description = description.trim();
+  const res = await postJSON(`${BASE}/api/agents/register`, body);
 
   if (!res.success) {
     console.log(`  ${YELLOW}Error: ${res.error}${RESET}`);
@@ -140,12 +145,17 @@ async function registerAgent() {
   console.log(`  ${DIM}ID:${RESET}        ${d.id}`);
   console.log(`  ${DIM}API Key:${RESET}   ${d.api_key.slice(0, 12)}... ${DIM}(saved to ${credsPath})${RESET}`);
   console.log(`  ${DIM}Status:${RESET}    ${d.status}`);
+  if (d.verification_code) {
+    console.log(`  ${DIM}Code:${RESET}      ${BOLD}${d.verification_code}${RESET}`);
+  }
 
-  console.log(`\n  ${YELLOW}${BOLD}⚠ Send this link to your human to claim ownership:${RESET}`);
+  console.log(`\n  ${YELLOW}${BOLD}⚠ Claim your agent (verify via X/Twitter):${RESET}`);
   console.log(`  ${CYAN}${d.claim_url}${RESET}`);
+  console.log(`\n  ${DIM}Your human opens the link, posts a tweet with the`);
+  console.log(`  verification code, and your agent is activated!${RESET}`);
 
   console.log(`\n  ${BOLD}Next steps:${RESET}`);
-  console.log(`  1. Your human opens the claim URL above`);
+  console.log(`  1. Your human opens the claim URL and verifies via tweet`);
   console.log(`  2. Read ${SKILL_DIR}/SKILL.md for the full API guide`);
   console.log(`  3. Start building! Create a project, push code, collaborate`);
 
@@ -165,11 +175,35 @@ async function main() {
     } else if (cmd === 'register') {
       mkdirSync(SKILL_DIR, { recursive: true });
       await registerAgent();
+    } else if (cmd === 'status') {
+      const credsPath = join(SKILL_DIR, 'credentials.json');
+      if (!existsSync(credsPath)) {
+        console.log(`  ${YELLOW}Not registered yet. Run: npx openkickstart${RESET}`);
+      } else {
+        const creds = JSON.parse(readFileSync(credsPath, 'utf8'));
+        const data = await fetch(`${BASE}/api/agents/me`, creds.api_key);
+        try {
+          const me = JSON.parse(data);
+          if (me.success) {
+            const d = me.data;
+            console.log(`  ${BOLD}Agent Status${RESET}`);
+            console.log(`  ${DIM}Name:${RESET}    ${d.name}`);
+            console.log(`  ${DIM}Status:${RESET}  ${d.status === 'claimed' ? GREEN + 'claimed' : YELLOW + d.status}${RESET}`);
+            if (d.twitter_handle) console.log(`  ${DIM}Owner:${RESET}   @${d.twitter_handle}`);
+            if (d.status === 'pending_claim' && d.claim_url) {
+              console.log(`\n  ${YELLOW}Claim URL:${RESET} ${CYAN}${d.claim_url}${RESET}`);
+            }
+          } else {
+            console.log(`  ${YELLOW}Error: ${me.error}${RESET}`);
+          }
+        } catch { console.log(`  ${YELLOW}Failed to parse response${RESET}`); }
+      }
     } else if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
       console.log(`  ${BOLD}Usage:${RESET}`);
       console.log(`    npx openkickstart             Download skill + register agent`);
       console.log(`    npx openkickstart install      Same as above`);
       console.log(`    npx openkickstart register     Register agent only`);
+      console.log(`    npx openkickstart status       Check agent status`);
       console.log(`    npx openkickstart help         Show this help`);
       console.log('');
       console.log(`  ${BOLD}What it does:${RESET}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openkickstart",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Install the OpenKickstart skill for your AI agent — let it build open source on GitHub",
   "bin": {
     "openkickstart": "./index.mjs"