Installation

The Forge CLI can be installed using the above commands. Open a Terminal window.

Installation Steps

  1. Clone the repository:
    git clone https://github.com/beachio/forge-cli.git
  2. Navigate to the directory:
    cd forge-cli
  3. Run the installation script:
    ruby install.rb
Note: This project is in need of an update, to help us prioritise - let us know that this would be impactful for you.

Prerequisites

Before installing the Forge CLI, ensure you have:

  • Ruby installed on your system
  • Git for cloning the repository
  • A Forge account (create one at getforge.com)
  • Access to a terminal or command prompt

Verification

After installation, verify the CLI is working:

  1. Open a new terminal window
  2. Run forge-cli --version to check the version
  3. Run forge-cli --help to see available commands

Troubleshooting

Common installation issues and solutions:

Ruby Not Found

If Ruby is not installed or not found:

  • Install Ruby using your system's package manager
  • On macOS: brew install ruby
  • On Ubuntu/Debian: sudo apt-get install ruby
  • Verify installation with ruby --version

Git Not Found

If Git is not installed:

  • Install Git from git-scm.com
  • On macOS: brew install git
  • On Ubuntu/Debian: sudo apt-get install git

Permission Errors

If you encounter permission errors during installation:

  • Ensure you have write permissions to the installation directory
  • Check that Ruby has the necessary permissions
  • Try running the installation script with appropriate permissions

Command Not Found

If the forge-cli command is not found after installation:

  • Check your PATH environment variable
  • Restart your terminal after installation
  • Verify the installation location and PATH configuration

Feedback

Since this CLI project is in need of updates, your feedback is valuable:

  • Let us know if this CLI would be impactful for your workflow
  • Report any issues or feature requests
  • Share your use cases and requirements
  • Help us prioritize improvements

Join the Discussion

Have questions or want to share your experience? Join our community discussion to connect with other developers and get help from the Forge team.

Visit Forum Discussion