{"id":21721072,"url":"https://github.com/anderly/dnsimple-cli","last_synced_at":"2025-04-12T21:33:50.072Z","repository":{"id":22566881,"uuid":"25908231","full_name":"anderly/dnsimple-cli","owner":"anderly","description":"DNSimple Command Line","archived":false,"fork":false,"pushed_at":"2015-02-09T17:14:56.000Z","size":970,"stargazers_count":12,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T15:47:59.643Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/anderly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-29T06:48:14.000Z","updated_at":"2021-12-03T11:57:29.000Z","dependencies_parsed_at":"2022-08-21T08:00:23.960Z","dependency_job_id":null,"html_url":"https://github.com/anderly/dnsimple-cli","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anderly%2Fdnsimple-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anderly%2Fdnsimple-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anderly%2Fdnsimple-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anderly%2Fdnsimple-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anderly","download_url":"https://codeload.github.com/anderly/dnsimple-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248636261,"owners_count":21137409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-26T02:13:43.052Z","updated_at":"2025-04-12T21:33:50.050Z","avatar_url":"https://github.com/anderly.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DNSimple CLI for Windows, Mac and Linux\n\n[![NPM version](http://img.shields.io/npm/v/dnsimple-cli.svg?style=flat)](https://npmjs.org/package/dnsimple-cli)\n[![Build Status](http://img.shields.io/travis/anderly/dnsimple-cli.svg?style=flat)](https://travis-ci.org/anderly/dnsimple-cli)\n[![License](http://img.shields.io/badge/license-Apache-red.svg?style=flat)](http://opensource.org/licenses/Apache-2.0)\n\nThis project provides a cross-platform command line interface for [DNSimple][0]. Specifically, it uses the [DNSimple REST API][2] via [nodejs-dnsimple](https://github.com/fvdm/nodejs-dnsimple) and its associated npm package [dnsimple](https://www.npmjs.org/package/dnsimple).\n\nThis project's command line interface is based on the [azure-cli](https://github.com/Azure/azure-sdk-tools-xplat), although its features and functionality are entirely different and not related to [azure](http://azure.microsoft.com/) whatsoever.\n\nInstallation\n------------\n\nThe release on npm is the latest stable version:\n\n```bash\nnpm install -g dnsimple-cli\n```\n\nThe code on Github is the most recent version, but can be unstable:\n\n```bash\nnpm install anderly/dnsimple-cli\n```\n\n### dnsimple cli on Ubuntu\nIf you want to run dnsimple cli on Ubuntu, then you should install **nodejs-legacy** instead of **nodejs**. For more information please check the following links:\n- [why there is a problem with nodejs installation on ubuntu](http://stackoverflow.com/questions/14914715/express-js-no-such-file-or-directory/14914716#14914716)\n- [how to solve the nodejs installation problem on ubuntu](https://github.com/expressjs/keygrip/issues/7)\n\nPlease perform the installation steps in following order:\n```bash\nsudo apt-get install nodejs-legacy\nsudo apt-get install npm\nnpm install -g dnsimple-cli\n```\n\n### Download Source Code\n\nTo get the source code of the SDK via **git** just type:\n\n```bash\ngit clone https://github.com/anderly/dnsimple-cli.git\ncd ./dnsimple-cli\nnpm install\n```\n\nUsage\n-----\n\nJust type `dnsimple` or `dns` at a command prompt to get started and see available commands. Please see the [command reference][3] and [wiki][4] for more details.\n\n```bash\nuser@host:~$ dnsimple\ninfo:         _           _                 _      \ninfo:        | |         (_)               | |     \ninfo:      __| |_ __  ___ _ _ __ ___  _ __ | | ___ \ninfo:     / _` | '_ \\/ __| | '_ ` _ \\| '_ \\| |/ _ \\\ninfo:    | (_| | | | \\__ \\ | | | | | | |_) | |  __/\ninfo:     \\__,_|_| |_|___/_|_| |_| |_| .__/|_|\\___|\ninfo:                                | |           \ninfo:                                |_|           \ninfo:    \ninfo:    DNSimple: We make DNS simple.\ninfo:    \ninfo:    Tool version 0.3.0\nhelp:    \nhelp:    Display help for a given command\nhelp:      help [options] [command]\nhelp:    \nhelp:    Log in to a DNSimple account.\nhelp:      login [options]\nhelp:    \nhelp:    Log out from DNSimple.\nhelp:      logout [options] [username]\nhelp:    \nhelp:    Open the DNSimple portal in a browser\nhelp:      portal [options]\nhelp:    \nhelp:    Commands:\nhelp:      account        Commands to manage your account information\nhelp:      config         Commands to manage your local settings\nhelp:      domain         Commands to manage domains\nhelp:      contact        Commands to manage your account contacts\nhelp:      service        Commands to manage your domain services\nhelp:      template       Commands to manage dns record templates\nhelp:      user           Commands to manage your users\nhelp:      subscription   Commands to manage account subscriptions\nhelp:      price          Commands to view domain pricing\nhelp:    \nhelp:    Options:\nhelp:      -h, --help     output usage information\nhelp:      -v, --version  output the application version\n```\n\nAuthentication\n-----\n\nAuthentication by **email + password** and **email + token** are both supported. If you authenticate using **email + password**, your account api token is retrieved and used for all subsequent calls. All credentials are securely stored in OS-specific secure credential stores such as OS X Keychain or Windows Credential Manager.\n\nThe DNSimple [sandbox][1] environment is supported in addition to [production][0].\n\n### Password Authentication\n\n```bash\n# This will prompt for your password in the console\ndnsimple login -u \u003cyour dnsimple account email address\u003e\n```\nor\n```bash\n# Specifying the -e --environment parameter allows you to login to the Sanbox enivonrment. \n# Production is the default.\ndnsimple login -u \u003cyour dnsimple account email address\u003e -e Sandbox\n```\n\n### Token Authentication\n\n```bash\ndnsimple login -u \u003cyour dnsimple account email address\u003e -t \u003cyour dnsimple account api token\u003e\n```\n\nCommands\n--------\nOnce authenticated, you can begin using the following top-level command categories:\n```\n# Command Categories:\naccount        Commands to manage your account information\ndomain         Commands to manage domains\ncontact        Commands to manage your account contacts\nservice        Commands to manage your domain services\ntemplate       Commands to manage dns record templates\nuser           Commands to manage your users\nsubscription   Commands to manage account subscriptions\nprice          Commands to view domain pricing\n```\nPlease see the [command reference][3] and [wiki][4] for more details.\n\n## Setting up Fiddler for CLI\n\nYou need to set the following environment variables to capture the HTTP traffic generated from the execution of dnsimple cli commands\n\n```bash\nset NODE_TLS_REJECT_UNAUTHORIZED=0\nset HTTPS_PROXY=http://127.0.0.1:8888\n```\n\n## Learn More\nPlease see the [command reference][3] and [wiki][4] for details and examples of all commands.\n\nFor more information on the DNSimple REST API, please see the [DNSimple API Documentation][2].\n\n## Contribute Code or Provide Feedback\n\nIf you would like to contribute to this project please [fork](https://github.com/anderly/dnsimple-cli/fork) the repo and submit a PR with any contributions.\n\nIf you encounter any bugs with the library please file an issue in the [Issues](https://github.com/anderly/dnsimple-cli/issues) section of the project.\n\n[0]:http://dnsimple.com\n[1]:http://sandbox.dnsimple.com\n[2]:http://developer.dnsimple.com/\n[3]:https://github.com/anderly/dnsimple-cli/blob/master/command-reference.md\n[4]:https://github.com/anderly/dnsimple-cli/wiki","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanderly%2Fdnsimple-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanderly%2Fdnsimple-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanderly%2Fdnsimple-cli/lists"}