Neowiki/Neocities CLI

From Penny's Pages
Jump to navigationJump to search
As taken from the neowiki
The media and text on this page, unless otherwise stated, has been taken from the neowiki, a now-inactive wiki, because of that, all of the contents on this page made for that wiki fall under the same license as the neowiki, that being MIT. This is different from Penny's Pages that uses a Creative Commons one.

Be aware that the information in the articles may now be incorrect as the project has not been active since 2019, however, unless a change has been made to the original copy of the wiki, please do not change or alter this page, even if you spot an error.

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 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). The Neocities CLI's specialty feature, though, is its pizza delivery service, which can be accessed through neocities pizza. Every time I've tried, they've been out of dough.. but hey, it's worth a shot.

External Links


  1. Original link to the article
  2. Article's description is "Neocities' command line interface."