@atollhq/skill-codex 0.1.7 → 0.1.9

package/README.md

@@ -8,15 +8,18 @@ Gives your Codex agent the ability to manage tasks, goals, KPIs, initiatives, mi
 
 ```bash
 npx @atollhq/skill-codex --key sk_atoll_... --org your-org-id
+# or
+ATOLL_API_KEY=sk_atoll_... ATOLL_ORG_ID=your-org-id npx @atollhq/skill-codex
 ```
 
 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_ID` 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'
@@ -20,24 +20,28 @@ function parseArgs(argv) {
 function printUsage() {
   console.log(`
 Usage: npx @atollhq/skill-codex --key <api-key> --org <org-id>
+   or: ATOLL_API_KEY=<api-key> ATOLL_ORG_ID=<org-id> npx @atollhq/skill-codex
 
 Options:
-  --key   Atoll API key (sk_atoll_...)
-  --org   Organization ID
+  --key   Atoll API key (sk_atoll_...). Defaults to ATOLL_API_KEY.
+  --org   Organization ID. Defaults to ATOLL_ORG_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_ID env vars
 `)
 }
 
 const args = parseArgs(process.argv)
+args.key ??= process.env.ATOLL_API_KEY
+args.org ??= process.env.ATOLL_ORG_ID
 
 if (args.help) { printUsage(); process.exit(0) }
 
 if (!args.key || !args.org) {
-  console.error('Error: --key and --org are required\n')
+  console.error('Error: provide --key and --org, or set ATOLL_API_KEY and ATOLL_ORG_ID\n')
   printUsage()
   process.exit(1)
 }
@@ -47,11 +51,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*/, '')
@@ -82,7 +92,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,7 +100,7 @@ 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')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atollhq/skill-codex",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Install the Atoll project management integration for Codex CLI",
   "bin": {
     "skill-codex": "bin/install.mjs"