> For the complete documentation index, see [llms.txt](https://wayfinder-1.gitbook.io/wayfinder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wayfinder-1.gitbook.io/wayfinder/readme.md).

# Wayfinder

One agent for all your crypto. Trade spot, perps, and prediction markets, manage positions across chains, run automated strategies, and schedule jobs that keep working while you sleep.

## Three ways in

### 1. Shells (start here)

Open the Wayfinder app and provision a Shell — your own agent in a sandboxed runtime, persistently running, transacting on your behalf within whatever permissions you set.

* Portfolio view with positions, P\&L, exposures, and TradingView charts
* Spot, perps, and prediction market trading from a single conversation
* Scheduled jobs for automation that runs even when you're away
* Non-custodial: wallets sign remotely, so the agent never holds your private keys
* Default model: DeepSeek V4 Pro, with GPT-5.6, Kimi K3, and a free tier to switch to

[Get started with Shells](/wayfinder/shells/app.md)

### 2. Paths (extend your agent)

Browse and install community-built plugins at [wayfinder.ai/app/paths](https://wayfinder.ai/app/paths). A Path can be a skill prompt, a dashboard applet, Python scripts, an autonomous strategy, live signals, or any combination. Creators bond $PROMPT to publish; the community stakes on quality.

[Explore Paths](/wayfinder/paths/paths.md)

### 3. SDK / CLI (advanced)

Clone the open-source SDK and run it in Claude Code, Codex, Opencode, or any MCP-compatible agent. Full programmatic access to every adapter, strategy, and MCP tool.

```bash
git clone https://github.com/WayfinderFoundation/wayfinder-paths-sdk
cd wayfinder-paths-sdk
# Open in your coding agent of choice
```

[SDK quickstart](/wayfinder/sdk-setup/quickstart.md)

## Example prompts

These work in the Wayfinder app or any agent connected to the Wayfinder SDK.

### What's in my wallet?

```
What's in my wallet?
```

Your agent reads balances across chains and gives you a multi-chain breakdown.

### Swap cross-chain

```
Swap 100 USDC on Arbitrum for PROMPT on Base.
First show me the quote, then ask for confirmation before executing.
```

### Check funding rates

```
Check the current ETH funding rate on Hyperliquid and tell me if it's positive or negative.
```

### Conditional multi-step trade

```
If ETH funding on Hyperliquid is positive:
1) Swap 100 USDC on Base into wstETH.
2) Short $100 notional ETH perp on Hyperliquid at 2x cross leverage.
Ask for confirmation before each fund-moving step.
```

## Get started

* [Provision a Shell](/wayfinder/shells/getting-started.md)
* [Browse Paths](/wayfinder/paths/paths.md)
* [SDK Quickstart](/wayfinder/sdk-setup/quickstart.md)
* [Architecture](/wayfinder/sdk-concepts/architecture.md)
* [Protocols](/wayfinder/protocols-and-adapters/protocols.md)