🥢 Tofuhub CLI

Tofuhub helps you deploy and manage open-source platforms with one command.

📦 Installation

``bash
npm install -g tofuhub


or just run with npx


npx tofuhub
`

---

🧭 Commands

$3

Authenticate your CLI session via browser.

`bash
tofuhub login
`

This will open a browser window where you can authenticate. Your credentials are stored locally.

---

$3

Clear your local session.

`bash
tofuhub logout
`

This removes the stored authentication token from your machine.

---

$3

Check your current session.

`bash
tofuhub whoami
`

Displays the currently logged-in user.

---

$3

Deploy a package to your cloud provider.

`bash
tofuhub deploy chirpstack
`

Tofuhub will:
- Ask for required variables (e.g. API tokens, passwords)
- Deploy infrastructure using OpenTofu
- Show logs and progress in real time

---

$3

Tear down an existing deployment in the current folder.

`bash
tofuhub destroy
`

Tofuhub will:
- Use saved state + variables
- Destroy your cloud resources
- Clean up local deployment files

---

$3

Initialise a tofuhub package

`bash
tofuhub init
`

Tofuhub will:
- Create a tofuhub.json file
- Create a .gitignore file

---

$3

Publish your own package to Tofuhub.

`bash
tofuhub publish
`

This will:
- Prompt for metadata (name, description, etc.)
- Package your .tf` files, README, and variables
- Push them to the Tofuhub registry

> You must be logged in to publish.

---

🛠️ Requirements

- Node.js 18+
- Git (for publish)
- A supported cloud provider (e.g., DigitalOcean)

---

🌱 Want to contribute?

Create a deployable open-source stack? Join the community and help grow the ecosystem.