Pooly CLI

npx pooly

That prints Welcome to POOLY, lists every command, then asks you to log in with the same email and password as pooly.org. After that you can create a pool and spend.

On Windows PowerShell, if you see npm.ps1 cannot be loaded, Windows is blocking scripts — not Pooly. Do not change ExecutionPolicy. Use Command Prompt, or:

npx.cmd pooly
npm.cmd install -g pooly

-g only puts pooly on this computer. You still type pooly when you want to run it. Someone else installs it on their machine.

pooly demo prints that same welcome card and stops — the tape used on /invest#cli-demo.

Every command starts with pooly.

pooly login

New account:

pooly signup
# Email:
# Password:

Or non-interactive:

pooly login --email [email protected] --password "your password"

pk_live_… is an agent API key from the website (Developers), not your password. Bots use --key. You do not need it.

Then:

pooly create --name "Saturday Dinner"
pooly fund "Saturday Dinner"
pooly spend --pool "Saturday Dinner" --gift walmart --amount 5 --yes

Commands

| Command | Notes | |---|---| | pooly | Welcome, command list, then login if needed | | pooly demo | Same boxed welcome + command card (no login, no extra logo) | | pooly login / signup / logout / whoami | Auth (email + password). Signup is optional. | | pooly pools / balance / activity | Read | | pooly pay / spend / approve / fund | Money movement | | pooly admin add <pool> --email [email protected] | Invite human admin by email | | pooly admin add <pool> --user @handle | Invite human admin by username | | pooly agents / agents add | Agents (AI/API — not the same as admin) | | pooly rules / rules edit | Permissions | | pooly delegate | Bounded authority | | pooly execute | Universal intent | | pooly subpools <pool> | List nested Pools (each has its own Safe) | | pooly subpool create --pool <parent> --name Snacks --allocate 10 | Create a sub-pool | | pooly tui | Optional full-screen UI |

If two Pools share a name, the CLI refuses the name and prints every id. Use that id:

pooly fund 81c3515b-6e7a-46cb-8758-ac946ae306f9

All important commands support --json for agents and scripts.

Config

~/.pooly/config.json. Env: POOLY_API_URL, POOLY_TOKEN, POOLY_AGENT_KEY.

Default API: https://pooly-be.onrender.com

Publishing (maintainers)

Package name on npm: pooly. Prefer GitHub Actions OIDC trusted publishing on tag cli-v*.

1. Enable trusted publisher → GitHub repo harrisqazi/pooly-be, workflow .github/workflows/publish-cli.yml
2. Tag: git tag cli-v0.2.9 && git push origin cli-v0.2.9
3. Workflow builds packages/cli, runs npm publish

Do not publish on every commit to main.