CLI
Search people and companies, reveal contacts, and call every Fiber endpoint from a terminal, a script, or a coding agent.
We built the Fiber CLI so you can search, reveal contacts, and call every
public endpoint from a terminal, a script, or a coding agent. The package is
@fiberai/cli. The command is fiber. You need Node.js 20 or newer.
A billed command quotes the cost and waits. --dry-run prints the request
and sends nothing. In a script or an agent, add --yes only after you
accept the quote. Without it, the command exits 6 and spends nothing.
What it does
- Install
fiber, or run one command withnpx. - Sign in once. The key stays off the command line.
- Run a built-in command for search, reveal, and credits, or invoke any other public endpoint.
- Read
chargeInfo. That field is the amount this call cost.
fiber status and a credit balance check are free.
Install and sign in
npm install -g @fiberai/cli
fiber auth login
fiber statusTo skip a global install, use npx @fiberai/cli in place of fiber.
| Situation | What you run |
|---|---|
| You already have an account | fiber auth login opens a browser |
| You are new to Fiber | fiber auth signup --email you@company.com, then finish with the emailed code |
| CI or a shared account | Pipe the key into fiber auth login --with-token |
| Sample data, never billed | fiber auth sandbox-key after you are signed in |
printf '%s' "$FIBER_API_KEY" | fiber auth login --with-tokenCreate the key at fiber.ai/app/api. Live keys, sandbox keys, and revocation are on API keys.
The CLI reads FIBER_API_KEY first, then the OS keychain, then
~/.config/fiber/credentials (owner-only). fiber status confirms the
session and does not print the key. fiber auth sandbox-key prints an
sk_test_ key for this shell only. It is not saved. Calls with that key
return sample data and are not billed.
There is no --api-key flag. Command-line arguments land in shell history
and are visible to other processes on the machine.
Inputs and outputs
You pass a plain-English query, a JSON filter object, or a LinkedIn URL. In
a terminal, searches print as tables and other commands print indented JSON.
When you pipe the output, or a coding agent or CI runs the command, you get
a JSON envelope. --json forces that envelope even in a terminal.
{
"ok": true,
"output": {},
"chargeInfo": {},
"advice": [],
"warnings": [],
"cli": { "command": "search nlp", "version": "0.1.2", "responseFile": null }
}advice is the next command worth running. On failure, ok is false and
error carries a code, a message, and whether you can retry. Branch on the
exit code as well as ok.
| Flag | What you get |
|---|---|
--brief | A short set of fields for that command |
--fields a,b.c | Only the paths you name |
--ndjson | One record per line |
--raw | The payload only, with no envelope |
--json | The envelope, even in a terminal |
Those flags do not change the charge. The rows were already fetched.
--limit is what changes the bill. A billed response is saved on your
machine. When you narrow the output, cli.responseFile is the full
response. Read that file when you need another field, instead of running
the search again.
Color follows NO_COLOR and FORCE_COLOR.
Commands
fiber --help lists every command. fiber help <command> explains one,
including its cost. fiber help --search <term> finds an endpoint by name.
An endpoint newer than your installed CLI still resolves from the live spec.
| Group | Commands |
|---|---|
auth | login, signup, logout, status, sandbox-key |
credits | balance, buy, limits |
search | nlp, people, companies |
contacts | reveal |
api | invoke |
skills | list, install, update |
| top-level | install, status, completion, help |
fiber search nlp --query "heads of sales at fintech companies" --limit 5
fiber search companies --params '{"domains":["stripe.com"]}' --limit 5
fiber contacts reveal --linkedin-url https://www.linkedin.com/in/example --tier standard| Operation | What it does | Reference |
|---|---|---|
| Natural-language search | Plain-English company or people search (fiber search nlp) | slushieRun |
| Company search | Structured company filters (fiber search companies) | companySearch |
| People search | Structured people filters (fiber search people) | peopleSearch |
| Contact reveal (normal) | One profile, inline (--tier standard, the default) | syncQuickContactReveal |
| Contact reveal (turbo) | Fastest single-profile reveal (--tier turbo) | syncTurboContactEnrichment |
| Contact reveal (exhaustive, start) | Deepest pass (--tier exhaustive) | triggerExhaustiveContactEnrichment |
| Contact reveal (exhaustive, poll result) | Read an exhaustive job you started with --no-wait | pollExhaustiveContactEnrichmentResult |
| Credit balance check | fiber credits balance | getOrgCredits |
| Credit top-up | fiber credits buy | buyCredits |
| Rate-limit lookup | fiber credits limits | getRateLimits |
Anything else is fiber api invoke plus the operation's JSON body. Names
and shapes are in the operations index.
fiber api invoke githubToLinkedinSingle --body '{"githubUsername":"likedan","outputType":"linkedin"}'Omit the reveal type flags to request work email, personal email, and phone
together. Pass --work-email, --personal-email, and/or --phone to
request a subset. The quote matches that combination. Exhaustive reveal
waits until the job finishes. --no-wait returns the task id so you can
poll later.
What each reveal tier returns is on Contact Reveal. Plain-English search behavior is on Natural-language search.
Using it effectively
Look up filter names with fiber help search companies or fiber help search people before you write --params. An unrecognized name is rejected before
the request is sent, and the message includes the closest real name.
Set --limit to the number of rows you will actually use. Pass --cursor
from the previous response to fetch the next page. Each page bills for the
rows it returns.
Run --dry-run before a large search or reveal, then add --yes only after
you accept the quote. Scripts and agents run non-interactively, so a billed
command needs --yes or it exits 6.
For a coding agent, fiber skills install claude or fiber skills install cursor writes a short command guide. fiber skills install with no host
writes the shared skills folder that Codex, OpenCode, Gemini CLI, Kilo, and
Cline read. fiber install <host> --dry-run prints the MCP config change.
fiber install <host> writes it and references FIBER_API_KEY instead of
embedding the secret. Add --project to write into the current repo. An
agent's shell cannot run fiber auth login. Ask the person to run that in
their own terminal. In Claude Code that is ! fiber auth login.
Use cases
A list from the terminal. Run natural-language search for a title and industry, then contact reveal on the LinkedIn URLs you keep.
A script or CI job. Sign in by piping a key, price the command with
--dry-run, pass --yes only for that command, and branch on the exit code.
A coding agent. Install the skill, let the agent run --dry-run, and
approve the spend yourself. MCP setup for the same hosts is on
MCP for AI agents. The plugin path is on
Developing with AI agents.
Exit codes
| Code | Meaning | Code | Meaning |
|---|---|---|---|
0 | Success | 5 | Unsupported |
1 | Error | 6 | Confirmation needed |
2 | Bad input | 7 | Not authenticated |
3 | One-time code needed | 8 | Payment required |
4 | Network failure | 9 | Rate limited |
Exit 6 means the command is waiting for --yes. Exit 2 means the input
was rejected before a charge.
Credits
The CLI has no separate price list. Each call bills like the underlying
operation. fiber status and a credit balance check are free. Trust the
confirmation line and chargeInfo over any static table. Per-org rates can
differ. See Billing & credits.
Related: API keys · SDKs · MCP · AI agents · Contact Reveal · Natural-language search
SDKs
Official TypeScript and Python SDKs for the Fiber AI API — typed requests, typed responses, and credit costs on every call.
MCP for AI agents
Connect Fiber to Claude, ChatGPT, Cursor, Claude Code, Codex, VS Code, and Windsurf via Model Context Protocol (MCP) — search companies, enrich contacts, and check credits from your agent.