{"id":31946714,"url":"https://github.com/censys/cencli","last_synced_at":"2026-04-27T08:01:58.544Z","repository":{"id":318735443,"uuid":"1073179596","full_name":"censys/cencli","owner":"censys","description":"Command line interface for interacting with Censys","archived":false,"fork":false,"pushed_at":"2026-04-23T18:52:03.000Z","size":11698,"stargazers_count":23,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T20:27:56.567Z","etag":null,"topics":["censys","censys-api"],"latest_commit_sha":null,"homepage":"https://censys.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/censys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","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":"2025-10-09T18:18:50.000Z","updated_at":"2026-04-23T18:52:07.000Z","dependencies_parsed_at":"2025-10-22T21:13:22.712Z","dependency_job_id":"6ae99ff9-a295-427f-ad8d-e1e881244ec2","html_url":"https://github.com/censys/cencli","commit_stats":null,"previous_names":["censys/cencli"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/censys/cencli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcencli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcencli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcencli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcencli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/censys","download_url":"https://codeload.github.com/censys/cencli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcencli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32327701,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"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":["censys","censys-api"],"created_at":"2025-10-14T11:22:29.770Z","updated_at":"2026-04-27T08:01:58.489Z","avatar_url":"https://github.com/censys.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Censys CLI\n\n`cencli` brings the authority of internet intelligence to your terminal. Analyze assets, perform queries, and hunt threats, all from the command line.\n\n![cencli](examples/cencli.gif)\n\nThe Censys CLI is available for free and paid users of the Censys Platform, with support for macOS, Linux, and Windows.\n\n## Quick Start\n\nMake sure you have `cencli` [installed](#installation) and it is on your `$PATH`.\n\n1. Run this command and follow the prompts to add your Censys Platform personal access token:\n\n    ```bash\n    $ censys config auth add\n    ```\n\n2. (Optional) Run this command and follow the prompts to add your Censys Platform organization ID:\n\n    ```bash\n    $ censys config org-id add\n    ```\n\n3. That's it! You can now perform asset lookups, searches, and more with the `censys` command.\n\n    ```bash\n    $ censys view 8.8.8.8\n    ```\n\n## Installation\n\nThis section describes how to get `cencli` on your system.\n\n### Homebrew\n\nmacOS and Linux users can install `cencli` using [Homebrew](https://brew.sh/):\n\n```bash\n$ brew install censys/tap/cencli\n```\n\nAt the end of the installation process, `zsh` and `bash` completion scripts will be automatically generated and linked to your shell environment.\n\n\u003e [!WARNING]\n\u003e Do NOT try to run `brew install censys`. This is a legacy formula that is no longer maintained and in no way affiliated with `cencli`.\n\nFor Windows users (and those who prefer not to use Homebrew), you will need to use different methods, which are described below.\n\n### Downloading the Binary\n\nStable binaries for different platforms (macOS/Linux/Windows) and architectures (amd64/arm64) are available for download on the [releases page](https://github.com/censys/cencli/releases). After you've downloaded and extracted the binary, make sure you add it to your `$PATH`.\n\n\u003e [!WARNING]\n\u003e For macOS users, your system may complain about the executable being untrusted after you try to run it. To bypass this, you can run `xattr -dr com.apple.quarantine /path/to/binary` to remove the quarantine flag. If you prefer to do this through the GUI, go to `Settings \u003e Privacy \u0026 Security` and allow the executable to be run.\n\n### Go Install\n\nIf you have Go 1.25+ installed, you can install `cencli` using the following command:\n\n```bash\n$ go install github.com/censys/cencli/cmd/cencli@latest\n# make sure to rename the executable to 'censys'\n$ mv \"$(go env GOPATH)/bin/cencli\" \"$(go env GOPATH)/bin/censys\"\n```\n\n### Build from source\n\nEnsure you have Go 1.25+ installed, and run the following commands:\n\n```bash\n$ git clone https://github.com/censys/cencli.git\n$ cd cencli\n$ make censys # builds the executable to ./bin/censys\n$ export PATH=$PATH:$(pwd)/bin\n$ censys --help\n```\n\n## Usage\n\n`cencli` supports various commands for accessing our platform. Run `censys --help` to see all available commands.\n\n### Configuration\n\nThe `config` command allows you to manage your personal access tokens and organization IDs. See the [config command docs](./docs/commands/CONFIG.md) for more details.\n\n### View\n\nThe `view` command allows you to fetch information about a particular host, certificate, or web property asset at a particular point in time. See the [view command docs](./docs/commands/VIEW.md) for more details.\n\n![view](examples/view/view.gif)\n\nYou can also use `-O short` (or `--output-format short`) to render output using templates, which can be customized. See the [templating documentation](./docs/commands/VIEW.md#templates) for more details.\n\n### Search\n\nThe `search` command allows you to perform Censys Platform searches, either globally or within a collection. See the [search command docs](./docs/commands/SEARCH.md) for more details.\n\n![search](examples/search/search.gif)\n\n### Aggregate\n\nThe `aggregate` command allows you to perform aggregate queries, either globally or within a collection. See the [aggregate command docs](./docs/commands/AGGREGATE.md) for more details.\n\n![aggregate](examples/aggregate/aggregate.gif)\n\n### Censeye\n\nThe `censeye` command allows you to perform a Censeye scan on a host. See the [censeye command docs](./docs/commands/CENSEYE.md) for more details.\n\n![censeye](examples/censeye/censeye-interactive.gif)\n\n### History\n\nThis is a WIP. See the [history command docs](./docs/commands/HISTORY.md) for more details.\n\n### Other Commands\n\n- `$ censys org`: manage and view organization details. See the [org command docs](./docs/commands/ORG.md) for more details.\n- `$ censys credits`: display credit details for your free user Censys account. See the [credits command docs](./docs/commands/CREDITS.md) for more details.\n- `$ censys completion \u003cbash|zsh|fish|powershell\u003e`: generates shell completion scripts\n- `$ censys version`: prints version information\n\n## License\n\nThis project is licensed under the Apache License 2.0.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcencli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcensys%2Fcencli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcencli/lists"}