An interactive command-line interface (CLI) tool to help you install, use, and administer an AO instance.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
deicidus 9a6a27e306 prettier install wizard 3 years ago
scripts prettier install wizard 3 years ago
.gitignore initial commit 3 years ago
.prettierignore stuck on POST bug (server not receiving payload) 3 years ago
.prettierrc stuck on POST bug (server not receiving payload) 3 years ago
LICENSE initial commit 3 years ago
README.md AO install wizard partway done, reorganized project repos, 'Check AO install' feature works, misc polish 3 years ago
index.js prettier install wizard 3 years ago
package-lock.json 0.1.1 3 years ago
package.json 0.1.1 3 years ago

README.md

ao-cli

ao-cli (alias ao) is a command-line interface (CLI) that helps you install, use, and configure the Autonomous Organization (AO). Command-line social networking for hackers.

To run immediately:

npx @autonomousorganization/ao-cli

To install:

npm i -g @autonomousorganization/ao-cli

Then you can run with ao-cli.

Features

These features work right now:

  • Browse the AO User Manual and automatically download and keep it updated
  • Manages your AO configuration file for you
  • Interactive install wizard install the AO for you
  • Wraps the functionality of (some of) Zen's Alchemy suite of scripts (system configuration, AO installation)
  • ao-cli can self-update to the newest version
  • Run AO unit tests to verify the up-to-spec functioning of the system's running AO API server
  • Easily view installed/running status of optional AO features
  • Add ao alias for ao-cli (under Features→ao-cli)
  • Detects your OS, with support for Debian/Ubuntu, Arch/Manjaro, and Fedora (MacOS planned)

Upcoming Features

These features are planned and many are mocked up in the menus:

  • Join the AO .onion bootstrapping network and find public AO chatrooms p2p over tor
  • Easily install/uninstall and turn on/off optional AO features
  • Operate essential AO client features (view and create priorities, create and send cards p2p via tor)
  • Easily install and configure your AO server installation
  • Easily use hardware-owner-only god-mode features for your AO server including resetting any password or deleting any member
  • Easily monitor your AO server status and start/stop the service
  • Easily switch between serving different AO frontends: ao-svelte, ao-3 (Vue), or ao-react
  • Easily update all your remote AOs at once
  • Easily install your preferred flavor of Unix on any unsecured Windows computer given its IP address (j/k)
  • Full interactive wizard to walk you through setting up and connecting new AO hardware resources to your AO server
  • Terminal spellbook to save and trade your favorite UNIX commands
  • AO server using AO features via ao-cli command line switches (with optional sound notifications on server computer)

Important Locations

  • ~/.ao/ Your AO saved data folder
  • ~/.ao/database.sqlite3 Location of your AO database (copy to back up)
  • ~/.ao/memes/ Files here will be loaded as card attachments when the AO server starts up
  • ~/ao-cli/ Typical location for ao-cli
  • ~/ao-svelte/ Typical location for ao-svelte
  • ~/ao-3/ Typical location for ao-3
  • ~/.ao/manual/ Typical location of the AO manual (Markdown files)
  • ~/Alchemy/ Typical location of Zen's Alchemy

Version History

  • 0.1.1 AO install wizard partway done, reorganized project repos, 'Check AO install' feature works
  • 0.1.0 View, create or recall, upboat and downboat priorities; partial AO install wizard
  • 0.0.9 Features menu loaded from module file for each feature; view top priority; menu cleanup
  • 0.0.8 Added self-update feature and --version/-v arg
  • 0.0.6 User manual downloads and updates automatically from official ao-manual repo
  • 0.0.5 Added browsable manual
  • 0.0.1 Menus prototyped