# bux-claude-agent

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 277 installs · ★ 98 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/bux-claude-agent/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bux-claude-agent

## What it 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.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/bux-claude-agent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/bux-claude-agent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/bux-claude-agent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/bux-claude-agent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills skills/bux-claude-agent
```

2. **Manually: put the files in place**
- File: `.github/skills/bux-claude-agent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/bux-claude-agent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bux-claude-agent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill bux-claude-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/bux-claude-agent/SKILL.md

## When to use it
- 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
- Set up `bux-claude-agent` on my Ubuntu VPS with `BROWSER_USE_API_KEY`, then verify the services.
- Configure the agent with Chromium and Telegram using `TG_BOT_TOKEN`, then run `claude /login`.
- Open `https://browser-use.com` in the managed browser and return its page title.

## Similar
- [fractera](https://affpapa.org/en/nevibecode/mcp/fractera.md) — MCP server · 335 installs
- [fingerprint-ci-gate](https://affpapa.org/en/nevibecode/skills/fingerprint-ci-gate.md) — skill · 132800 installs
- [electron-chromium-upgrade](https://affpapa.org/en/nevibecode/skills/electron-chromium-upgrade.md) — skill · 625 installs
- [pinchtab](https://affpapa.org/en/nevibecode/skills/pinchtab.md) — skill · 902 installs
- [setup-browser-cookies](https://affpapa.org/en/nevibecode/skills/setup-browser-cookies.md) — skill · 379 installs
- [open-gstack-browser](https://affpapa.org/en/nevibecode/skills/open-gstack-browser.md) — skill · 347 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 211 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
