Redo CLI

The Redo CLI lets you work on a site from your terminal. It is for people who like code files.

How it works

The CLI is a bridge. One side is your Redo site. The other side is a local .redo folder.

You log in. You pick a site. Then the CLI can pull pages and blocks down to your computer. You edit those files. Then you push them back.

Redo site
  ↓ pull
.redo folder
  ↓ edit
Redo site
  ↑ push

Install

The CLI runs on Node. Install it from npm.

npm install -g @redopage/cli
redo --help
cms --help

redo is the main command. cms is the same tool with a short name.

The main flow

Start with login. The browser asks you to approve the CLI. After that the CLI gets a token. The token lets it talk to Redo for you.

redo login

Next pick a site. Most commands use this site until you switch.

redo site list
redo use <site-id>

Now you can look around.

redo list pages
redo read page 1
redo info

When you want to edit, pull files down. The files land in .redo/.

redo pull page 1
redo dev

Edit the files. Then push them back. The push is the return trip.

redo push page 1

Publish when the site is ready.

redo publish 1

What lives in .redo

The .redo folder is the workbench. It holds page files, block files, settings, forms, and downloads.

.redo/
  pages/
  blocks/
  settings/
  forms/
  downloads/

Think of each page as a small box. The page has a JSON file. Its blocks sit next to it. This keeps edits easy to see.

Command groups

Safety notes

redo pull writes files in .redo. Save your work before you pull again.

redo delete asks before it deletes. In scripts you must pass --yes. That keeps sharp tools in a sheath.

Get help

The CLI can teach you from the terminal.

redo help
redo help topics
redo help quickstart
redo help publish

Next: CLI login