x402agent/solanaos/public
Claude Code and agent skill by x402agent/solanaos
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install x402agent/solanaos/publicSKILL.md
The same SKILL.md was published earlier as x402agent/solanaos/public.
SolanaOS — Agent Skill Sheet
Give this file to any AI agent (Claude, Codex, GPT-4, MiniMax, etc.) to fully install, configure, and run SolanaOS in one shot.
What You Are Installing
SolanaOS Companion — an autonomous Solana trading agent by SolanaOS Labs.
- Single ~10MB Go binary (
solanaos) - Runs a full OODA trading loop (RSI + EMA + ATR strategy)
- Telegram bot with live strategy controls
- Chrome extension with wallet + miner card
- Bitaxe Gamma 602 Bitcoin miner integration
- x402 payment protocol for monetized APIs
- macOS menu bar app + persistent LaunchAgent daemon
- Powered by a local-first Ollama harness (default:
minimax-m2.7:cloud)
Prerequisites
The agent should verify these exist before proceeding:
go>= 1.21 (go version)git(git --version)curl(curl --version)- macOS (for LaunchAgent) or Linux (for systemd)
- A
.envfile in the project root (see Step 2)
Step 1 — Clone the Repo
Step 2 — Create .env
Create a .env file in the project root. Minimum required fields:
Step 3 — Build
Or build manually:
Step 4 — Onboard (First Run)
This generates the agent wallet, creates ~/.solanaos/config.json, and validates your API keys.
Step 5 — Run the Daemon
Option A: Foreground (development)
Option B: Persistent macOS LaunchAgent (recommended)
Option C: Docker
Option D: systemd (Linux)
Step 6 — Verify
Step 7 — Chrome Extension
- Open
chrome://extensions - Enable Developer mode (top right toggle)
- Click Load unpacked
- Select the
chrome-extension/folder in this repo - Click the SolanaOS Control icon in the toolbar
The extension auto-connects to http://127.0.0.1:7777.
Step 8 — Bitaxe Miner (Optional)
After this the Chrome extension shows a live hashrate card and Telegram responds to /miner.
Step 9 — Use the Local MiniMax Harness (Optional)
Telegram Commands Reference
| Command | Description | |
|---|---|---|
/status | Full runtime dashboard: model, wallet, Honcho, Aster, Hyperliquid, services | |
/wallet | Wallet address + SOL balance | |
/personality | Set bot persona and preferred name | |
/trending | Trending Solana tokens | |
/ooda | Trigger OODA cycle | |
/sim | Switch to simulated mode | |
/live | Switch to live trading mode | |
/strategy | Show strategy parameters | |
/set <param> <value> | Live-edit strategy (e.g. /set rsi_period 12) | |
/miner | Bitaxe hashrate, temp, power | |
/research <mint> | Deep research a token | |
/trades | Recent trade history | |
/web <query> | Grok web search | |
/xsearch <query> | Grok X search | |
/deepsolana <prompt> | Force the local Ollama harness path | |
/help | All commands |
Strategy Parameters (live-editable via /set)
| Parameter | Default | Range | |
|---|---|---|---|
rsi_period | 14 | 5–30 | |
rsi_overbought | 72 | 60–90 | |
rsi_oversold | 28 | 10–40 | |
ema_fast | 9 | 3–20 | |
ema_slow | 21 | 10–100 | |
stop_loss | 7 | 1–20 (%) | |
take_profit | 25 | 5–100 (%) | |
position_size | 10 | 1–20 (%) |
Key Files
| File | Purpose | |
|---|---|---|
main.go | CLI entrypoint — all commands | |
pkg/daemon/daemon.go | Orchestrator — wallet, OODA, Telegram, miner | |
pkg/strategy/strategy.go | RSI + EMA + ATR signal engine | |
pkg/config/config.go | Config struct + Load/Save | |
pkg/nanobot/server.go | Local HTTP server (port 7777) | |
chrome-extension/ | MV3 Chrome extension | |
scripts/install-service.sh | macOS LaunchAgent installer | |
scripts/bitaxe-quickstart.sh | Bitaxe auto-setup | |
strategy.md | Strategy documentation | |
docs/bitaxe-setup.md | Bitaxe full setup guide |
Common Issues
| Problem | Fix | |
|---|---|---|
| Port 7777 in use | lsof -i :7777 → kill the process | |
| Telegram 409 Conflict | pkill -f "solanaos" then restart | |
| Wallet not found | Run solanaos onboard | |
| Extension shows offline | Make sure daemon is running, check curl http://127.0.0.1:7777/api/status | |
| Build fails | Run go mod tidy then make build |
One-Shot Agent Prompt
If you want an AI agent to do the entire setup automatically, paste this:
SolanaOS Companion · Built by SolanaOS Labs · Apache 2.0
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingdocs/docs-site/public/skill.md
Popularity
- Repository stars
- 9
- Repository forks
- 2
- 7-day trend score
- 12
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 20 May 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/x402agent/solanaos/public)