{"id":50833960,"url":"https://github.com/wyrd-company/seek-cli","last_synced_at":"2026-06-14T02:05:35.250Z","repository":{"id":360767731,"uuid":"1239375102","full_name":"wyrd-company/seek-cli","owner":"wyrd-company","description":"A CLI tool for agents to request deep research into a subject","archived":false,"fork":false,"pushed_at":"2026-05-27T19:01:53.000Z","size":76,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T21:05:13.066Z","etag":null,"topics":["answers","bun","cli","deep-research","homebrew","web-scraping","web-search"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wyrd-company.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T03:12:27.000Z","updated_at":"2026-05-27T19:01:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wyrd-company/seek-cli","commit_stats":null,"previous_names":["wyrd-company/seek-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/wyrd-company/seek-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wyrd-company%2Fseek-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wyrd-company%2Fseek-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wyrd-company%2Fseek-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wyrd-company%2Fseek-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wyrd-company","download_url":"https://codeload.github.com/wyrd-company/seek-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wyrd-company%2Fseek-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34306774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["answers","bun","cli","deep-research","homebrew","web-scraping","web-search"],"created_at":"2026-06-14T02:05:30.021Z","updated_at":"2026-06-14T02:05:35.243Z","avatar_url":"https://github.com/wyrd-company.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Seek CLI (`seek`)\n\nAgent-friendly CLI for web search, deep research, and targeted scraping across popular APIs.\n\nBuilt with [Bun](https://bun.sh) + TypeScript. Each command groups providers by intent so an agent (or human) can pick the right trade-off between speed, cost, and output type.\n\n## Install\n\nWith Homebrew:\n\n```sh\nbrew install wyrd-company/tools/seek-cli\n```\n\nFrom source:\n\n```sh\nbun install\nbun link            # exposes the `seek` binary on your PATH\n# or run directly without linking:\nbun run src/index.ts ...\n```\n\nTo produce a single-file native binary:\n\n```sh\nbun run build       # -\u003e dist/seek\n```\n\n## Authentication\n\nEach provider reads its own API key. `seek` resolves them in this order:\n\n1. Process environment variable (always wins — useful for CI and one-off overrides).\n2. Config file at `$XDG_CONFIG_HOME/seek/config.json`, falling back to `~/.config/seek/config.json`.\n\n| Provider      | Env var / config key    |\n| ------------- | ----------------------- |\n| Parallel      | `PARALLEL_API_KEY`      |\n| Exa           | `EXA_API_KEY`           |\n| Brave Search  | `BRAVE_SEARCH_API_KEY`  |\n| Brave Answers | `BRAVE_ANSWERS_API_KEY` |\n| Perplexity    | `PERPLEXITY_API_KEY`    |\n| Google        | `GEMINI_API_KEY`        |\n| Firecrawl     | `FIRECRAWL_API_KEY`     |\n\nTo set up the config file:\n\n```sh\nseek config init        # writes a template at ~/.config/seek/config.json (mode 0600)\nseek config path        # print the resolved path\nseek config show        # show which keys are configured (values masked)\n```\n\nThe config file is a flat JSON object whose keys match the env var names, so you can mix and match without learning a second schema:\n\n```json\n{\n  \"EXA_API_KEY\": \"sk-…\",\n  \"PERPLEXITY_API_KEY\": \"pplx-…\"\n}\n```\n\n## Command map\n\n```\nseek\n├── web         Fast, real-time context retrieval\n│   ├── parallel       Dense, LLM-ready context in one call (best for agents)\n│   ├── exa            Neural semantic search (best for conceptual queries)\n│   ├── brave\n│   │   ├── search     Independent global web index (best for real-time facts)\n│   │   └── answers    AI-generated answers backed by verifiable sources\n│   └── perplexity     Short, conversational answer with citations\n│\n├── research    Autonomous, multi-step deep analysis\n│   ├── brave          Brave Answers Deep Research\n│   ├── parallel       Strict JSON output with auditable sources (B2B / data ops)\n│   ├── google         Long-horizon, Google-grounded report (corporate / scientific)\n│   └── perplexity     Polished long-form briefing with inline citations\n│\n└── scrape      Targeted raw page extraction\n    ├── exa            Bulk page parsing optimized for LLM token windows\n    ├── parallel       Web agent that can authenticate through logins and paywalls\n    └── firecrawl      Clean Markdown / JSON / HTML from any live URL\n```\n\n## Examples\n\n```sh\n# Real-time search\nseek web parallel \"transformer inference cost in 2026\" -n 5\nseek web exa \"papers on speculative decoding\" --category \"research paper\" --text\nseek web brave search \"latest Anthropic model release\" --fresh pw\nseek web brave answers \"what shipped in the latest Bun release?\" --citations\nseek web perplexity \"what changed in the EU AI Act this month?\"\n\n# Deep research\nseek research brave \"what changed in the EU AI Act this month?\" --citations\nseek research parallel \"list the top 10 EV battery manufacturers\" \\\n  --schema ./schema.json --processor pro\nseek research google \"summarize the SEC investigation into ACME Corp\"\nseek research google \"map the competitive landscape for open-weight speech models\" \\\n  --interactive --planner perplexity\nseek research perplexity \"state of the small language model market\"\n\n# Scrape\nseek scrape exa https://example.com https://example.org\nseek scrape parallel https://app.example.com/dashboard --objective \"Extract the latest invoice table\"\nseek scrape firecrawl https://example.com -f markdown,links\n```\n\nEvery subcommand supports `--json` to emit the raw provider response — useful when piping into `jq` or another agent.\n\n## CI and release\n\nRun the same checks as CI locally:\n\n```sh\nbun run ci\n```\n\nBuild release archives locally:\n\n```sh\nRUN_CI=0 bun run release\n```\n\nPushing a version tag such as `0.1.0` runs the release workflow. It builds macOS/Linux ARM64 and x86_64 tarballs, publishes them to the GitHub release, then updates `Formula/seek-cli.rb` in `github.com/wyrd-company/homebrew-tools`.\n\nThe tap publish job expects an SSH deploy key in the repository secret `FORMULAE_PUBLISH_KEY` with write access to `wyrd-company/homebrew-tools`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwyrd-company%2Fseek-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwyrd-company%2Fseek-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwyrd-company%2Fseek-cli/lists"}