// command line

The forge CLI

A single-file Node.js script. Push and pull projects to Forge from your terminal — no Git required.

1 · Install as `forge`

One-liner — downloads the CLI and installs it as forge on your $PATH (Node 18+ required):

curl -fsSL https://forgeinit.app/forge-cli.mjs -o /usr/local/bin/forge && chmod +x /usr/local/bin/forge

No write access to /usr/local/bin? Install to your home dir instead:

mkdir -p ~/.local/bin
curl -fsSL https://forgeinit.app/forge-cli.mjs -o ~/.local/bin/forge
chmod +x ~/.local/bin/forge
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Verify: forge help

2 · Get a token

Go to settings → access tokens and generate one. Copy it.

3 · Log in

forge login fg_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Stored at ~/.forge/config.json.

4 · Push a project

cd ~/code/my-app
forge init <your-username>/my-app
forge push -m "initial commit"

5 · Pull / clone

forge clone <owner>/<repo>
# or inside an initialized folder
forge pull

All commands

forge login <token> — save your access token
forge logout — clear local credentials
forge whoami — show signed-in user
forge init <owner/repo> — link this folder to a repo
forge push -m "msg" — upload all files as a new commit
forge pull — replace local files with the latest commit
forge clone <owner/repo> — copy a repo into a new folder
forge log — show commit history