Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.reposeek.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
CLI

The Reposeek CLI is published as @reposeek/cli.

​
Requirements

  • Node.js >=18
  • Reposeek API key

​
One-shot usage

REPOSEEK_API_KEY="replace-me" npx @reposeek/cli@latest search "self-hosted calendly alternative" --limit 3

​
Global install

npm install -g @reposeek/cli
reposeek login
reposeek search "nextjs saas starter stripe api keys" --limit 5

​
Authentication Patterns

​
Saved local login

reposeek login
reposeek search "self-hosted calendly alternative" --limit 3
reposeek login asks for an existing dashboard-created API key and stores it in your user-level Reposeek config directory. The key is not printed back to the terminal.

​
One-shot env var

REPOSEEK_API_KEY="replace-me" npx @reposeek/cli@latest search "react admin dashboard" --limit 3
Use this for CI, agents, and commands where you do not want to mutate local CLI state. REPOSEEK_API_KEY takes priority over saved credentials.

​
Local API base URL

reposeek config set api-base-url http://localhost:8000
reposeek auth status
Use this only when targeting a local or non-production API. REPOSEEK_API_BASE_URL takes priority over saved config for one process environment.

​
Auth Commands

reposeek auth status
reposeek logout
auth status verifies the effective credential without consuming search quota. Running logout removes the saved local credential but does not revoke the dashboard API key.

​
Command

reposeek search "<query>" [--limit N]
Argument or flagDescription
<query>Natural-language description of the repo you need.
--limit NOptional result count from 1 to 10. Defaults to 3.
The CLI prints only the API response JSON unchanged on success: top-level request_id plus results with stars and forks. Response headers and timing are available to direct HTTP clients, not surfaced in CLI output. Quota-exhausted responses are printed to stderr as JSON and preserve error.usage.remaining_searches and error.usage.next_reset_at when the API returns those fields.