agent/CLAUDE.md: orientation + voice + ssh/scp how-tos

[LarsenCundric]

Three additions based on early user feedback:

(1) Top-of-file orientation. "You are bux — the user's 24/7 personal agent". The old opener jumped straight into browser instructions; new users would ask "what is this thing" and claude would answer with technical specs instead of role.

(2) Voice section ("How you talk"). Action-first, concise, honest-when-stuck, confirm time/scope when scheduling. Most common piece of feedback was "claude sounds too chatty / like a bot".

(3) "How the user gets stuff to/from you" — explicit recipes for the three channels:

• Telegram (primary, the bot handles it)
• SSH — ssh-copy-id bux@<ip> then ssh bux@<ip>. Claude points users at this if asked.
• File transfer — scp ~/Downloads/foo.zip bux@<ip>:~/. Claude knows to ls -lat ~ | head when the user says "I uploaded a file".

The cloud-side CLAUDE.md is gitignored (baked from this OSS canonical copy at AMI build time), so this OSS PR is the only place the edits need to land.

Test plan

• Bake AMI, deploy box, ask "what are you?" → claude answers with the new orientation, not "I'm Claude".
• User asks "how do I send you a file?" → claude gives the scp recipe.
• User asks "can I ssh in?" → claude gives the ssh-copy-id steps.
• Ask claude to do something tomorrow → reply confirms time in UTC.

---

Summary by cubic

Updates agent/CLAUDE.md with a top-of-file orientation, voice guidelines, and clearer Telegram/SSH/file-transfer recipes. SSH setup now uses a paste-your-pubkey-only flow (no ssh-copy-id) to match passwordless config and avoid bootstrap failures.

• New Features

  • Orientation: bux is the user’s 24/7 agent; Browser Use Cloud only; files live in /home/bux.
  • Voice: action-first, concise, no filler; honest when stuck; confirm time/scope.
  • Channels:
    • Telegram: bot relays messages; slash-commands handled by the bot.
    • SSH: ssh-copy-id can’t bootstrap; user runs cat ~/.ssh/id_*.pub on their laptop and pastes; you append to ~/.ssh/authorized_keys on the box with correct perms; never read laptop keys on the box.
    • File transfer: scp/rsync to ~/; use ls -lat ~ | head to find new uploads; user usually pulls results back via scp.

• Bug Fixes

  • Removed a stale footer that referenced an ssh-copy-id path, preventing contradictions with the paste-your-pubkey flow.

^{Written for commit 778d9c6. Summary will update on new commits. Review in cubic}

[cubic-dev-ai]

1 issue found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="agent/CLAUDE.md">

<violation number="1" location="agent/CLAUDE.md:28">
P2: The fallback public-key command is documented in a laptop context, but it must run on the bux box. As written, users may append their key to the wrong machine and still be unable to SSH in.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

1 issue found across 1 file (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="agent/CLAUDE.md">

<violation number="1" location="agent/CLAUDE.md:36">
P2: Path A implies `ssh-copy-id` always works, but with password auth disabled it cannot bootstrap first access unless another auth method already works.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

1 issue found across 1 file (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="agent/CLAUDE.md">

<violation number="1" location="agent/CLAUDE.md:27">
P2: The new SSH instructions conflict with existing guidance by forbidding `ssh-copy-id` while the section still tells users to follow “Path A”/`ssh-copy-id`, which can produce inconsistent responses.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}