Clipy (clp)

Local CLI for humans and coding agents. One binary on PATH, intent commands (not raw Google/Jira JSON), CLI-only login. Agents should never rewrite API or OAuth code.

This is not a hosted 1,000-app catalog (see Composio). v1 ships Google Sheets only. Other plugins are listed as planned.

Install

npm i -g clipy-kit
clp doctor --json
clp setup          # if `clp` is not on PATH (common with macOS npm prefixes)

Or without a global install: npx --package clipy-kit clp doctor --json

From a clone:

npm install
npm run build
node dist/cli.js setup

Skills:

npx skills add /path/to/this/repo --skill clipy -g
npx skills add /path/to/this/repo --skill clipy-sheet -g

Auth (Sheets)

clp sheet auth login --credentials ./client_secret.json
clp sheet auth login --service-account ./sa.json
clp sheet auth status --pretty

Credentials: ~/.config/clipy/sheet/ (override CLIPY_CONFIG_DIR / GSHEET_CONFIG_DIR). Enable Sheets API and Drive API on the Google Cloud project.

Usage

clp --help --json
clp plugin list --json
clp sheet read <id> --tab Sheet1 --limit 20
clp sheet upsert <id> --tab Sheet1 --key-col Name --rows '[{"Name":"Kopi"}]' --dry-run
clp sheet format header <id> --tab Sheet1

Data commands print JSON on stdout ({ ok, cmd, result }). Host commands (setup, doctor, --help) use color on a TTY; pass --json for agents. NO_COLOR=1 disables ANSI.

Programmatic

import { createOps, GoogleClient, getAccessToken } from 'clipy-kit';

const ops = createOps(new GoogleClient(() => getAccessToken()));
await ops.readTable(id, { tab: 'Sheet1', limit: 20 });

License

MIT