Skip to content

chore(cli): migrate from scripts/cookiy.sh to npm cookiy-cli - #39

Open
yupeng-dev wants to merge 5 commits into
mainfrom
chore/cli-migrate-to-npm
Open

chore(cli): migrate from scripts/cookiy.sh to npm cookiy-cli#39
yupeng-dev wants to merge 5 commits into
mainfrom
chore/cli-migrate-to-npm

Conversation

@yupeng-dev

Copy link
Copy Markdown
Contributor

Summary

The bundled shell CLI references/cookiy/scripts/cookiy.sh is superseded by the standalone cookiy-cli TypeScript package distributed via npm.

What changed in this repo

  • Removed references/cookiy/scripts/cookiy.sh (977 lines)
  • Replaced every scripts/cookiy.sh <cmd> example with npx cookiy-cli <cmd> across all module docs (8 files)
  • Added an Install / Upgrade section to references/cookiy/cookiy.md with npx / npm install -g / npm update -g guidance

How agents should use it now

# Zero install — preferred for first-time use
npx cookiy-cli save-token <access_token>
npx cookiy-cli study list --limit 10

# Or install globally for a shorter `cookiy` command
npm install -g cookiy-cli
cookiy study list --limit 10

# Keep it current
npm update -g cookiy-cli

Requires Node.js 18+.

Supersedes

Closes #38 (the intermediate Node.js rewrite). That PR was part of the same migration path and is replaced by this one + the new standalone repo.

Test plan

  • cookiy-cli@1.21.0 published to npm (verified npx cookiy-cli --version)
  • cookiy-cli live-tested locally: billing balance, study list, quant list, quant get, billing transactions return identical JSON structure to the removed shell CLI
  • claude plugin validate after merge (SKILL.md + plugin manifests unaffected, expected pass)

🤖 Generated with Claude Code

The bundled shell CLI is superseded by the standalone `cookiy-cli`
TypeScript package published to npm:

    https://www.npmjs.com/package/cookiy-cli
    https://github.com/cookiy-ai/cookiy-cli

Changes:
- Remove references/cookiy/scripts/cookiy.sh
- Replace every `scripts/cookiy.sh <cmd>` example with `npx cookiy-cli <cmd>`
  across all module reference docs
- Add Install / Upgrade section to references/cookiy/cookiy.md with
  npx / npm install -g / npm update -g instructions

Supersedes #38 (the Node.js rewrite intermediate step).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
yupeng and others added 4 commits April 20, 2026 16:32
All module examples now invoke `cookiy <subcommand>` directly — the
`npx cookiy-cli <subcommand>` wording was a transition crutch. The
expected flow is:

    npm install -g cookiy-cli        # first-time only
    cookiy <subcommand>

Rewrote Install / Upgrade section in references/cookiy/cookiy.md to
tell agents to verify `command -v cookiy` and install globally before
running commands. All 8 module reference docs now use the `cookiy`
binary form exclusively.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Matches cookiy-cli@1.21.1 which removed all server-side wait/polling
flags (the shell CLI had already dropped them in commit 3885545).

- Remove `study guide wait` subcommand section
- Remove `study report wait` subcommand section
- Rewrite qual.md's "Waiting on Async Operations" to point at
  `cookiy study status` as the sole progress-check path

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Previous commit (0ea460b) used `git add -A` which slurped up untracked
audit artifacts that are tracked separately. Revert them back to
untracked; only the CLI migration + wait-removal docs belong in this PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The prior removal was too aggressive — cookiy-cli still supports both
`study guide wait` and `study report wait` (reintroduced in 1.21.7).
Restore the corresponding reference sections and update cookiy-qual.md
to point back at them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant