Neocities' CLI

From Penny's Pages
Jump to navigation Jump to search

A command-line interface or command language interpreter (CLI), also known as command-line user interface, console user interface, and character user interface (CUI), is a means of interacting with a computer program where the user (or client) issues commands to the program in the form of successive lines of text (command lines). A program which handles the interface is called a command language interpreter or shell (computing).

The Neocities CLI is a utility written in the Ruby programming language to interface with the Neocities API from a terminal. It allows a website to be managed entirely through the console, without the use of a web browser.


The Neocities CLI runs on any platform with Ruby and its Gem package manager installed. Run gem install neocities and it will install.

In the case of macOS or Linux users, the page on Neocities' website advises to run it with sudo if there are permissions issues. If the installation has an error about rake not being installed, run gem install rake before trying again.


Using any of the Neocities CLI's functions will prompt you to enter your site's username and password. After this, it will store the API key and you won't need to enter it again.

A full list of the CLI's functions can be found by just typing neocities into the terminal.

If you have an existing site, you may want to download and extract it first through the Neocities dashboard, so you can jump into editing right away.

You can push the entire directory to your site by going to the folder and running neocities push ..

Additionally, you can upload files (neocities upload), delete files (neocities delete), list your files (neocities list), get stats (neocities info), or log out (neocities logout).


  1. Original wiki article about this subject
  2. Command-line interface
  3. neowiki article
  4. Neocities' Cli
  5. neocities/neocities-ruby - The Github repository for the CLI