Command Line

The FlowLeap backend, in your terminal.

One CLI for patent search, literature, legal research, citations, and full-corpus analytics, built for humans and the AI agents you work alongside. Stable JSON, documented exit codes, and a dry-run for every request.

Install the CLI View on GitHub

flowleap

$ flowleap patent search --query "solid-state battery" --limit 5✓ 5 results across EPO + USPTO$ flowleap analytics --keyword battery --country US --date-from 2020-01-01✓ 12,480 filings · trend +18% · top CPC H01M$ flowleap --json summary EP1000000

Twenty-six commands, one binary.

The same patent data behind the FlowLeap workspace, scriptable from your shell.

Patent Search

Search EPO and USPTO by technology, assignee, or date, then read the full record: bibliography, claims, family, and legal status.

Query Builder

Turn a plain-English question into a CQL or USPTO query, and dry-run it to see the exact request before it runs.

Literature & Law

Academic papers, non-patent literature, and hybrid search over patent-law references: MPEP, EPC, and EPO guidelines.

Examiner Citations

Backward and forward citations with X, Y, and A examiner categories, so you see what destroys novelty and what only frames it.

Full-Corpus Analytics

Filing trends, top countries, assignees, and CPC breakdowns across 170 million publications, returned in seconds.

Documents & Claims

OCR a patent PDF, analyze a claim's elements, or pull a one-call summary, timeline, comparison, or figures for any patent.

Agent-grade by design.

Every command is safe to hand to a model: predictable output, predictable failure, and a next step on every error.

Stable JSON everywhere

Add --json to any command for a machine-readable envelope. --dry-run prints the exact request first, so an agent never guesses.

Documented exit codes

Every run exits with a documented code (3 for auth, 4 for subscription, 6 for rate limit), so a script can branch without parsing output.

Structured failure hints

Failures carry a hint that tells an agent exactly what to do next: log in, add a provider key, back off, or surface an upgrade URL to a human.

Install in One Line

Pick a channel, then sign in with flowleap auth login.

npm

npm i -g flowleap

Quick Install (macOS / Linux)

curl -fsSL https://flowleap.co/install.sh | sh

From Source (Rust)

cargo install --git https://github.com/flowleap-ai/flowleap-cli.git

The npm package runs no install scripts. The native binary is downloaded on first run, verified against the release checksum, and published with npm provenance. Binaries cover macOS, Linux (including a static musl build), and Windows.

Prefer to let your agent do it?

Paste this into Claude Code, Cursor, or any coding agent, and it installs and signs in for you.

agent-setup-prompt

Set up FlowLeap Patent AI for me. FlowLeap is a patent-research toolkit: a CLI (npm package `flowleap`) plus an agent skill pack.

1. Install the CLI: run `npm install -g flowleap` (or `curl -fsSL https://flowleap.co/install.sh | sh` if npm isn't available). Verify with `flowleap --version`.
2. Authenticate: run `flowleap auth login` and follow the device-code sign-in it prints — it creates a free FlowLeap account if I don't have one. For headless/CI, use a `fl_pat_` API token instead (see `flowleap auth --help`).
3. Install the skills so you know how to drive FlowLeap:
   - If you are Claude Code: run `/plugin marketplace add flowleap-ai/flowleap-plugins` then `/plugin install flowleap@flowleap-plugins`.
   - Any other agent: run `flowleap skills install` (installs the skill pack into ~/.claude/skills).
4. Verify: run `flowleap --json doctor` and tell me the auth + backend status, then briefly summarize what FlowLeap can now do (patent search, prior-art, freedom-to-operate, dashboards).

If any step needs EPO/USPTO provider keys or an interactive browser sign-in, stop and tell me rather than guessing.

Access & Sign-In

The CLI is free and open source. The patent-data commands call the FlowLeap backend, which needs an account.

A FlowLeap plan

Data commands require a FlowLeap account with an active plan — a free 7-day trial starts at sign-up. Without one, commands return a clear 402 with an upgrade URL, never a silent failure.

Headless & CI

Sign in once with flowleap auth login, then mint a revocable token with flowleap auth create-token and export FLOWLEAP_TOKEN wherever the CLI runs.

See Pricing

Skills for Your Agents

Bundled Agent Skills teach any model how to use FlowLeap, installed straight into the harness it already loads.

One install command

flowleap skills install writes SKILL.md documentation, or a condensed rules file, into the location your agent auto-loads. flowleap skills update keeps it fresh.

Every major harness

Target Claude Code, Codex, Cursor, or Gemini CLI, at user level or per project. 32 skills ship inside the binary and install offline.

14 workflow recipes

Multi-step playbooks your agent runs end to end: prior art, freedom-to-operate, claim analysis, office-action response, invalidity, and infringement charting.

flowleap skills install                  # Claude Code (~/.claude/skills)
flowleap skills install --target cursor  # ./.cursor/rules/flowleap.mdc
flowleap skills update                   # refresh after upgrading

Bring FlowLeap to your terminal.

Install the CLI, sign in, and run your first patent search in under a minute.

Install from npm Read the Docs