generated: '2026-08-13'
method: searched
source: https://github.com/Surfe/surfer
description: >-
  First-party distributable clients for the Surfe API. Surfe publishes ONE
  first-party package — the `surfer` command-line client, written in Go and
  distributed through its own Homebrew tap and GitHub Releases. Surfe publishes
  no server-side SDK / client library in any language registry: npm, PyPI,
  RubyGems and crates.io were all searched on 2026-08-13 and returned no
  first-party Surfe package.
packages:
- language: go
  registry: github-releases
  name: surfer
  module: github.com/Surfe/surfer
  url: https://github.com/Surfe/surfer
  kind: cli
  install: brew install surfe/tap/surfer-cli
  install_alternatives:
  - "curl -sL https://github.com/Surfe/surfer/releases/latest/download/surfer_darwin_arm64.tar.gz | tar xz"
  - "git clone https://github.com/Surfe/surfer.git && cd surfer && make install"
  official: true
  license: MIT
  version: v0.1.2
  published: '2026-07-01'
  version_source: https://proxy.golang.org/github.com/!surfe/surfer/@latest
  note: >-
    The official Surfe CLI. Binary is `surfer`; the Homebrew formula is named
    `surfer-cli` to avoid a clash with an unrelated `surfer` in homebrew-core.
    Version and date read from the Go module proxy (@latest -> v0.1.2,
    2026-07-01T22:19:23Z), corroborated by the GitHub release tag v0.1.2
    published 2026-07-01 and the generated Homebrew formula (version 0.1.2).
    Not listed on pkg.go.dev (GET https://pkg.go.dev/github.com/Surfe/surfer
    returned 404 on 2026-08-13) — it is a command, not an importable library.
- language: go
  registry: homebrew
  name: surfer-cli
  tap: surfe/tap
  url: https://github.com/Surfe/homebrew-tap
  kind: cli
  install: brew install surfe/tap/surfer-cli
  official: true
  version: 0.1.2
  published: '2026-07-01'
  version_source: https://raw.githubusercontent.com/surfe/homebrew-tap/main/Formula/surfer-cli.rb
  note: >-
    Surfe's own Homebrew tap. The formula is generated by GoReleaser from each
    `Surfe/surfer` release; the repository README says formulae must not be
    edited by hand. Version read from the `version "0.1.2"` line in the formula.
sdks: []
sdk_note: >-
  No first-party client library. Searched 2026-08-13: npm registry search for
  "surfe" returned no Surfe-published package; pypi.org/pypi/{surfe,surfe-api,
  surfe-sdk,pysurfe}/json all 404; rubygems.org/api/v1/gems/surfe.json 404;
  crates.io/api/v1/crates/surfe 404. Surfe's own developer docs ship cURL,
  JavaScript, Go, Python and TypeScript request SAMPLES per endpoint, not a
  packaged SDK. The `Surfe/api-examples` repo (Python, last pushed 2025-05-29)
  holds example scripts, not a library.
related_repositories:
- name: Surfe/api-examples
  url: https://github.com/surfe/api-examples
  description: Surfe's Public API examples and use cases
  language: python
  official: true
  last_pushed: '2025-05-29'
  note: Example scripts and integration examples; not a published package.
registries_checked:
- {registry: npm, query: surfe, result: no first-party package}
- {registry: pypi, queries: [surfe, surfe-api, surfe-sdk, pysurfe], result: 404}
- {registry: rubygems, query: surfe, result: 404}
- {registry: crates.io, query: surfe, result: 404}
- {registry: proxy.golang.org, query: github.com/Surfe/surfer, result: v0.1.2}
- {registry: pkg.go.dev, query: github.com/Surfe/surfer, result: 404}