# Config

> View and modify fibx CLI configuration, such as setting custom RPC URLs to avoid rate limits. Changes are hot-reloaded automatically — no restart needed.

- Skill: `fibrous-finance/config` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fibrous-finance/config`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fibrous-finance/config/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: Fibrous-Finance (https://skillmd.com/u/fibrous-finance)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fibrous-finance/config

---


# Configuration Management

Manage local configuration for the `fibx` CLI. The primary use case is setting custom RPC URLs for supported chains to bypass public RPC rate limits or connection issues.

## Prerequisites

- None.

## Rules

1. **Rate Limits**: If a tool fails with a "Rate limit exceeded" or "429" error, use this skill to check the current RPC and set a new one.
2. **Hot-Reload**: Config changes take effect immediately — no need to restart the CLI or MCP server. The config file is monitored via mtime-based hot-reload.
3. **Persistence**: Settings are stored locally in an OS-dependent config directory (e.g. `~/.config/fibx-nodejs/config.json` on Linux, `~/Library/Preferences/fibx-nodejs/config.json` on macOS) and persist across sessions.
4. **Validation**: The CLI validates URL format but not connectivity. Ensure the RPC URL is valid before setting.

## Commands

```bash
# Set a custom RPC
npx fibx@latest config set-rpc <chain> <url>

# Get current RPC
npx fibx@latest config get-rpc <chain>

# Reset a single chain to default
npx fibx@latest config reset-rpc <chain>

# Reset all chains to default
npx fibx@latest config reset-rpc

# List all configs
npx fibx@latest config list
```

## Parameters

| Parameter | Type   | Description                              | Required |
| --------- | ------ | ---------------------------------------- | -------- |
| `chain`   | string | `base`, `hyperevm`, or `monad` | Yes      |
| `url`     | string | The full HTTP(S) RPC endpoint URL        | Yes      |

## Examples

**User:** "I'm getting rate limit errors on Base."
**Agent:** "I will set a custom RPC for Base."

```bash
npx fibx@latest config set-rpc base https://mainnet.base.org
```

**User:** "Check my current configuration."

```bash
npx fibx@latest config list
```

**User:** "Reset Base RPC to default."

```bash
npx fibx@latest config reset-rpc base
```

**User:** "Reset all custom RPCs."

```bash
npx fibx@latest config reset-rpc
```

## Error Handling

| Error               | Action                                         |
| ------------------- | ---------------------------------------------- |
| `Unsupported chain` | Check spelling of chain name.                  |
| `Invalid URL`       | Ensure URL starts with `http://` or `https://` |

## Related Skills

- All other skills may trigger rate limit errors that this skill resolves.
- Use `get-rpc` to verify the current RPC before troubleshooting connectivity issues.