Official CLI · betav0.1.0-beta.1

Proven ideas,one command away.

Search the library, inspect a complete idea and pull its build prompt directly into your project—all through a zero-dependency, read-only CLI.

Install the CLIView source on GitHub

Node.js 22.14+ · 0 dependencies · MIT-licensed client

~/next-project

$ proventools search "developer analytics"

TitleCategory

Developer Funnel InspectorAnalytics

SDK Adoption MonitorDevTools

Page 1 of 1 · stored read · 0 credits

$ _

Install and authenticate

Two commands to start.

Create an API key in your dashboard first. Login validates it, then saves it in a private owner-only config file.

Open Agent access →
01

Install the exact beta

terminal
npm install --global proventools@0.1.0-beta.1
02

Save and validate your key

terminal
proventools login
Enter the key only at the hidden login prompt. Never put it in a command, prompt, checked-in environment file, shell profile or log.

Command surface

Small enough to remember.

Four working commands cover the research-to-build handoff. Every API read costs 0 credits.

01proventools search "developer analytics"

Search the curated idea library.

02proventools show <idea-id>

Read the complete breakdown for one idea.

03proventools pull <idea-id>

Write its build prompt to a new local Markdown file.

04proventools whats-new

Inspect the latest monthly idea drop.

pull creates a private.prompt.md file and refuses to overwrite an existing file.

Bundled agent skill

Teach your agent the safe workflow.

The npm package includes a concise SKILL.md for Codex, Claude Code and compatible agents. It covers secret handling, untrusted API content and approval before file writes.

terminal
proventools skill-path

Security behavior

Hidden login
The key is read from a private prompt, not a command argument or shell history.
Private storage
The saved configuration uses owner-only directory and file permissions.
Trusted network
Credentials are sent only to approved ProvenTools origins or local loopback development.
Safe output
Terminal control characters are stripped and API responses are size-bounded.
No overwrite
Pull refuses to replace an existing prompt file.
Read only
The CLI cannot change your account, library data or credit balance.

Want these tools inside your agent?

The local MCP beta reuses the same saved credential and adds no hosted server.

Set up the MCP server