cyberneticlibrary
← library

Build new Oclif CLI commands

new-commandsubagentsetup L2★0
KennethWussmann/simplelogin-cli ↗
What it does

Create new Oclif CLI commands with TypeScript and SDK integration

Best for

Creating production Oclif commands for SimpleLogin CLI that follow resource-action patterns, support --format output (plain/json/yaml), and integrate with simplelogin-client SDK with full error handling.

Inputs
  • · CLI_DESIGN.md spec
  • · resource-action naming
  • · API endpoint requirements
  • · flag/argument definitions
Outputs
  • · src/commands/[resource]/[action].ts
  • · test file with Mocha/Chai
  • · updated README and oclif.manifest.json
Requires
  • · @oclif/core v4
  • · simplelogin-client SDK
  • · Mocha/Chai
  • · YAML config
Preconditions
  • · CLI_DESIGN.md specifies command path
  • · simplelogin-client SDK installed
  • · Oclif v4 project structure
  • · Node16 ES module resolution
Failure modes
  • · Import path wrong if .js extension omitted in ES modules
  • · Config permission denied if ~/.config/simplelogin-cli not 600
  • · API endpoint 404 if endpoint renamed in SDK
  • · Auth required if config missing API token
Trust signals
  • · Explicit resource-action hierarchy (sl alias list → src/commands/alias/list.ts)
  • · Global flags support (--format, --config)
  • · Exit code semantics (0=success, 1=general, 2=invalid, 3=auth, 4=API, 5=network)
  • · Config validation (file permissions 600 for security)
  • · Multi-format output generation