Fiber AI
Build

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

  1. Install fiber, or run one command with npx.
  2. Sign in once. The key stays off the command line.
  3. Run a built-in command for search, reveal, and credits, or invoke any other public endpoint.
  4. 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 status

To skip a global install, use npx @fiberai/cli in place of fiber.

SituationWhat you run
You already have an accountfiber auth login opens a browser
You are new to Fiberfiber auth signup --email you@company.com, then finish with the emailed code
CI or a shared accountPipe the key into fiber auth login --with-token
Sample data, never billedfiber auth sandbox-key after you are signed in
printf '%s' "$FIBER_API_KEY" | fiber auth login --with-token

Create 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.

FlagWhat you get
--briefA short set of fields for that command
--fields a,b.cOnly the paths you name
--ndjsonOne record per line
--rawThe payload only, with no envelope
--jsonThe 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.

GroupCommands
authlogin, signup, logout, status, sandbox-key
creditsbalance, buy, limits
searchnlp, people, companies
contactsreveal
apiinvoke
skillslist, install, update
top-levelinstall, 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
OperationWhat it doesReference
Natural-language searchPlain-English company or people search (fiber search nlp)slushieRun
Company searchStructured company filters (fiber search companies)companySearch
People searchStructured 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-waitpollExhaustiveContactEnrichmentResult
Credit balance checkfiber credits balancegetOrgCredits
Credit top-upfiber credits buybuyCredits
Rate-limit lookupfiber credits limitsgetRateLimits

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

CodeMeaningCodeMeaning
0Success5Unsupported
1Error6Confirmation needed
2Bad input7Not authenticated
3One-time code needed8Payment required
4Network failure9Rate 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

On this page