bux-claude-agent — Claude Code skill: setup
bux-claude-agent runs Claude Code on an Ubuntu VPS with a persistent Chromium session and Telegram control. Useful when browser logins and state must survive restarts.
no license 277 installs ★ 98 updated 2026-10-09
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a claude-codeWhat bux-claude-agent does
This skill sets up Claude Code as a long-running agent on an Ubuntu VPS. Chromium stays available with its cookies and logins, while agent data is kept under /home/bux across reboots. You can send tasks through Telegram, and the agent can hand back a live browser view when a CAPTCHA or 2FA step needs your input.
The setup uses three systemd services: bux-browser-keeper keeps Chromium alive, bux-ttyd exposes a localhost web terminal, and bux-telegram bridges Telegram when a token is supplied. BROWSER_USE_API_KEY is required for the browser connection. Claude still needs a separate claude /login step, and the documented host requirement is Ubuntu 22.04+ with at least 2GB RAM.
What it helps with
- deploy a persistent Claude Code agent on an Ubuntu VPS
- keep Chromium cookies and logins across restarts
- control a browser agent through Telegram
- hand CAPTCHA or 2FA steps to a human
- inspect the agent’s systemd services
Example prompts for the agent
- Set up
bux-claude-agenton my Ubuntu VPS withBROWSER_USE_API_KEY, then verify the services. - Configure the agent with Chromium and Telegram using
TG_BOT_TOKEN, then runclaude /login. - Open
https://browser-use.comin the managed browser and return its page title.
How to install bux-claude-agent
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a claude-code2Manually: put the files in place
~/.claude/skills/bux-claude-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bux-claude-agent/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a codex2Manually: put the files in place
.agents/skills/bux-claude-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a cursor2Manually: put the files in place
.cursor/skills/bux-claude-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills skills/bux-claude-agent2Manually: put the files in place
.github/skills/bux-claude-agent/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/bux-claude-agentManually: put the files in place
.devin/skills/bux-claude-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bux-claude-agent
How do I install bux-claude-agent in Claude Code?
Run npx skills add reason-machines/trending-skills --skill bux-claude-agent -a claude-code, then check ~/.claude/skills/bux-claude-agent/SKILL.md.
What does bux-claude-agent do?
It deploys Claude Code on an Ubuntu VPS, keeps a browser session alive, and provides Telegram control. A live browser view is available for interactive CAPTCHA, 2FA, or login steps.
What is required for bux-claude-agent to work?
Use an Ubuntu 22.04+ VPS with at least 2GB RAM and provide BROWSER_USE_API_KEY. Telegram control uses TG_BOT_TOKEN, and Claude authentication is completed with claude /login.