# Neocities' CLI

### The majority of this article uses text form Wikipedia or a similar wikia.

Most, or a lot of the text on this page is taken from neowiki, try and make most of the article original.

`04/09/18`

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.

## Installation

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.

## Usage

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`).

`References
I. Command-line interface
https://en.wikipedia.org/wiki/Command-line_interface
II. neowiki article https://minerobber.neocities.org/neowiki/neocities_cli.html
III. Neocities' Cli https://neocities.org/cli
III. neocities/neocities-ruby - The Github repository for the CLI https://github.com/neocities/neocities-ruby

This page was last updated: 04/09/2018 @ 17:05

In total this page has had 0 updates since it was uploaded.

`
★