Skip to main content

​
Install the CLI

Run the install script:
curl -fsSL https://raw.githubusercontent.com/FlipsideCrypto/flipside-tools/main/install.sh | sh
This downloads the latest binary and adds it to your PATH.

​
Authenticate

Log in with your Flipside account: 
flipside login
This opens your browser to authenticate. Your credentials are stored locally in ~/.flipside/.

​
Verify Setup

Confirm you’re logged in and see your account info: 
flipside whoami
You should see your username and organization.

​
Quick Test

Run a simple query to verify everything works: 
flipside query create "SELECT block_number, block_timestamp FROM ethereum.core.fact_blocks LIMIT 5"

​
Updating the CLI

Keep your CLI up to date: 
flipside update

​
Configuration

View your current configuration: 
flipside config

​
Environment Selection

Switch between environments using the -e flag: 
flipside -e prod query list    # Production (default)
flipside -e staging query list # Staging
Or set a default environment: 
flipside config set env prod

​
Uninstall

To remove the CLI: 
# Remove the binary
rm $(which flipside)

# Remove configuration (optional)
rm -rf ~/.flipside

​
Troubleshooting

The install script adds the binary to /usr/local/bin. If this isn’t in your PATH, add it:
export PATH="/usr/local/bin:$PATH"
Add this line to your ~/.bashrc, ~/.zshrc, or shell config file to make it permanent.
The install script may need sudo access to write to /usr/local/bin:
curl -fsSL https://raw.githubusercontent.com/FlipsideCrypto/flipside-tools/main/install.sh | sudo sh
Or install to a user directory:
mkdir -p ~/.local/bin
curl -fsSL https://raw.githubusercontent.com/FlipsideCrypto/flipside-tools/main/install.sh | sh -s -- --install-dir ~/.local/bin
If the browser doesn’t open automatically, the CLI will display a URL. Copy and paste it into your browser manually.
Clear your stored credentials and log in again:
flipside logout
flipside login
Most common issue: Terminal not restarted after adding to PATH.
  1. Restart your terminal completely (close and reopen)
  2. Verify PATH includes your directory
  3. Test with full path: C:\Users\YourName\flipside-tools\flipside.exe --version
  • Right-click flipside.exe → Properties → Unblock (if present)
  • Run terminal as Administrator if needed

​
Next Steps

Interactive Chat

Start exploring data with natural language

Run Agents

Use AI agents for analysis