@atollhq/skill-codex 0.1.6 → 0.1.8

package/README.md

@@ -7,16 +7,17 @@ Gives your Codex agent the ability to manage tasks, goals, KPIs, initiatives, mi
 ## Install
 
 ```bash
-npx @atollhq/skill-codex --key sk_atoll_... --org your-org-slug
+npx @atollhq/skill-codex --key sk_atoll_... --org your-org-id
 ```
 
 Get an API key from **Settings > Members > Add Agent** (or **Create API Key** for integrations) in the Atoll app.
 
-This does three things:
+This does four things:
 
-1. Appends (or updates) an `# Atoll Integration` section in `~/.codex/AGENTS.md`
-2. Copies API reference files to `~/.codex/atoll-references/`
-3. Appends `ATOLL_API_KEY` and `ATOLL_ORG_SLUG` exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
+1. Installs the `atoll-api` skill to `~/.codex/skills/atoll-api/`
+2. Appends (or updates) an `# Atoll Integration` section in `~/.codex/AGENTS.md`
+3. Copies API reference files to `~/.codex/atoll-references/`
+4. Appends `ATOLL_API_KEY` and `ATOLL_ORG_ID` exports to your shell profile (`~/.zshrc` or `~/.bashrc`)
 
 Open a fresh shell (or `source` your profile) and Codex has the Atoll integration.
 

package/bin/install.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs'
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { homedir } from 'node:os'
 import { fileURLToPath } from 'node:url'
@@ -19,16 +19,17 @@ function parseArgs(argv) {
 
 function printUsage() {
   console.log(`
-Usage: npx @atollhq/skill-codex --key <api-key> --org <org-slug>
+Usage: npx @atollhq/skill-codex --key <api-key> --org <org-id>
 
 Options:
   --key   Atoll API key (sk_atoll_...)
-  --org   Organization slug
+  --org   Organization ID
   --help  Show this help message
 
 Installs the Atoll integration for Codex CLI:
+  - Installs the atoll-api skill to ~/.codex/skills/atoll-api/
   - Writes AGENTS.md with API reference to ~/.codex/
-  - Sets ATOLL_API_KEY and ATOLL_ORG_SLUG env vars
+  - Sets ATOLL_API_KEY and ATOLL_ORG_ID env vars
 `)
 }
 
@@ -47,11 +48,17 @@ if (!args.key.startsWith('sk_atoll_')) {
   process.exit(1)
 }
 
-// 1. Write AGENTS.md to ~/.codex/
+// 1. Install the Codex skill to ~/.codex/skills/atoll-api/
 const codexDir = join(homedir(), '.codex')
 mkdirSync(codexDir, { recursive: true })
 
 const skillDir = join(__dirname, '..', 'skill')
+const skillDest = join(codexDir, 'skills', 'atoll-api')
+mkdirSync(skillDest, { recursive: true })
+cpSync(skillDir, skillDest, { recursive: true })
+console.log(`Installed Atoll skill to ${skillDest}`)
+
+// 2. Write AGENTS.md to ~/.codex/
 const skillMd = readFileSync(join(skillDir, 'SKILL.md'), 'utf-8')
 // Strip YAML frontmatter for AGENTS.md
 const body = skillMd.replace(/^---[\s\S]*?---\n*/, '')
@@ -63,7 +70,7 @@ ${body}
 ## Credentials
 
 - API Key: set as ATOLL_API_KEY environment variable
-- Org: ${args.org}
+- Org ID: ${args.org}
 `
 
 const agentsPath = join(codexDir, 'AGENTS.md')
@@ -82,7 +89,7 @@ if (existsSync(agentsPath)) {
 }
 console.log(`Wrote Atoll instructions to ${agentsPath}`)
 
-// 2. Copy reference files
+// 3. Copy reference files for compatibility with older installs
 const refsDir = join(codexDir, 'atoll-references')
 mkdirSync(refsDir, { recursive: true })
 for (const file of ['api-endpoints.md', 'api-fields.md']) {
@@ -90,25 +97,32 @@ for (const file of ['api-endpoints.md', 'api-fields.md']) {
 }
 console.log(`Copied API references to ${refsDir}`)
 
-// 3. Set env vars in shell profile
+// 4. Set env vars in shell profile
 const shell = process.env.SHELL || '/bin/bash'
 const profilePath = shell.includes('zsh')
   ? join(homedir(), '.zshrc')
   : join(homedir(), '.bashrc')
 
-const envBlock = `\n# Atoll (added by @atollhq/skill-codex)\nexport ATOLL_API_KEY="${args.key}"\nexport ATOLL_ORG_SLUG="${args.org}"\n`
+function upsertExport(profile, name, value) {
+  const line = `export ${name}="${value}"`
+  const pattern = new RegExp(`^export ${name}=.*$`, 'm')
+  if (pattern.test(profile)) return profile.replace(pattern, line)
+  return `${profile.trimEnd()}\n${line}\n`
+}
 
 if (existsSync(profilePath)) {
-  const profile = readFileSync(profilePath, 'utf-8')
-  if (profile.includes('ATOLL_API_KEY')) {
-    console.log(`ATOLL_API_KEY already set in ${profilePath} — update manually if needed`)
-  } else {
-    writeFileSync(profilePath, profile.trimEnd() + '\n' + envBlock)
-    console.log(`Added ATOLL_API_KEY and ATOLL_ORG_SLUG to ${profilePath}`)
+  let profile = readFileSync(profilePath, 'utf-8')
+  if (!profile.includes('# Atoll (added by @atollhq/skill-codex)')) {
+    profile = `${profile.trimEnd()}\n\n# Atoll (added by @atollhq/skill-codex)\n`
   }
+  profile = upsertExport(profile, 'ATOLL_API_KEY', args.key)
+  profile = upsertExport(profile, 'ATOLL_ORG_ID', args.org)
+  writeFileSync(profilePath, profile)
+  console.log(`Configured ATOLL_API_KEY and ATOLL_ORG_ID in ${profilePath}`)
 } else {
+  const envBlock = `\n# Atoll (added by @atollhq/skill-codex)\nexport ATOLL_API_KEY="${args.key}"\nexport ATOLL_ORG_ID="${args.org}"\n`
   writeFileSync(profilePath, envBlock)
-  console.log(`Created ${profilePath} with ATOLL_API_KEY and ATOLL_ORG_SLUG`)
+  console.log(`Created ${profilePath} with ATOLL_API_KEY and ATOLL_ORG_ID`)
 }
 
 console.log(`\nDone! Restart your shell, then Codex will have access to the Atoll API.`)

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@atollhq/skill-codex",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Install the Atoll project management integration for Codex CLI",
   "bin": {
-    "skill-codex": "./bin/install.mjs"
+    "skill-codex": "bin/install.mjs"
   },
   "files": [
     "bin/",
@@ -18,7 +18,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/atollhq/atoll.git",
+    "url": "git+https://github.com/atollhq/atoll.git",
     "directory": "packages/skill-codex"
   },
   "license": "MIT",