The Bags CLI (@bagsfm/bags-cli) is a terminal tool that wraps the Bags API and SDK into simple commands. It lets you trade tokens, launch tokens, claim fees, manage fee share configs, and more all without writing code.
Requirements
Verify your Node version:
Installation
Install globally via npm:
npm install -g @bagsfm/bags-cli
npx @bagsfm/bags-cli --help
bags binary is available in your terminal:
Quick Start with bags setup
The fastest way to get going is the first-run wizard. It configures your RPC endpoint, imports your wallet, and authenticates in a single command:
The wizard prompts you for:
- Solana RPC URL — defaults to
https://api.mainnet-beta.solana.com if left blank
- Private key — accepts a base58-encoded key or a JSON integer array
- MFA code — if your account has MFA enabled
You can also pass everything as flags for non-interactive use:
bags setup \
--rpc-url https://your-rpc-provider.com \
--private-key YOUR_BASE58_PRIVATE_KEY \
--key-name "My CLI Key"
| Flag | Description | Default |
|---|
--rpc-url <url> | Solana RPC endpoint | https://api.mainnet-beta.solana.com |
--private-key <key> | Base58 private key or JSON integer array | Prompted interactively |
--key-name <name> | Label for the generated API key | Bags CLI Key |
Manual Setup (Step by Step)
If you prefer to configure each piece individually:
1. Create or Import a Wallet
Generate a new Solana keypair:
Or import an existing key:
bags wallet import --key YOUR_BASE58_PRIVATE_KEY
~/.config/bags/keypair.json.
2. Authenticate
Log in using the wallet signature flow. The CLI handles the challenge/sign/callback sequence automatically:
If your account has MFA enabled, you’ll be prompted for the code.
| Flag | Description | Default |
|---|
--keypair <path> | Path to a custom keypair file | ~/.config/bags/keypair.json |
--key-name <name> | Label for the API key | Bags CLI Key |
bags settings set --rpc-url https://your-rpc-provider.com --commitment confirmed
4. Verify
Check that everything is working:
bags auth status
bags wallet show
Configuration Files
All CLI state lives under ~/.config/bags/:
| File | Purpose |
|---|
keypair.json | Your Solana keypair (secret key bytes). Permissions are set to 0600. |
credentials.json | API key, key ID, wallet address, and authentication timestamp. Permissions are set to 0600. |
config.json | CLI settings: RPC URL, commitment level, output mode. |
Never share your keypair.json or credentials.json. These files contain secrets that grant full access to your wallet and API key.
Global Options
Every command supports these global flags:
| Flag | Description |
|---|
--json | Force machine-readable JSON output regardless of settings |
--input-json <json> | Provide options as a JSON object, merged with any explicit flags |
--input-json flag is useful for scripting. Explicit CLI flags take precedence over values in the JSON object:
bags trade quote --input-json '{"inputMint":"So11...","outputMint":"EPjF...","amount":1000000}'
Output Modes
Control how the CLI formats its output:
bags settings set --output json
| Mode | Description |
|---|
pretty | Human-friendly colored output (default) |
table | Tabular format for list data |
json | Raw JSON for piping into other tools |
Uninstalling
Remove credentials and keypair:
Uninstall the package:
npm uninstall -g @bagsfm/bags-cli
Next Steps
