ops-jrz1/docs/onboarding-dan.md
Dan 1b1a91f9cb Switch to user-managed npm for AI coding tools
- Remove manual /usr/local/bin/claude install
- Remove claude symlink setup from learner-add.sh
- Update onboarding docs with npm install instructions
- Users choose their AI coder: claude, opencode, gemini, codex

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-02 19:03:35 -08:00

118 lines
2.2 KiB
Markdown

# Dev Environment Onboarding
Welcome! You have access to a remote dev server for building Slack bots with AI-assisted coding.
## What You Get
- SSH access to a Linux server
- Claude Code CLI (AI coding assistant)
- Python + uv (fast package manager)
- Slack bot tokens (shared test workspace)
## Setup (5 minutes)
### 1. Add SSH Config
Add this to `~/.ssh/config` on your laptop:
```
Host dev-server
HostName 45.77.205.49
User dan
LocalForward 8080 127.0.0.1:8080
```
### 2. Connect
```bash
ssh dev-server
```
### 3. Install your AI coding tool
```bash
npm install -g @anthropic-ai/claude-code # or gemini-cli, codex
```
### 4. Authenticate (first time only)
```bash
claude auth # Opens browser for OAuth
```
## Your First Bot
```bash
mkdir ~/mybot && cd ~/mybot
claude "create a python slack bot using slack-bolt that responds 'Hello!' when someone says hello"
# or: opencode, gemini, codex - whichever you installed
```
Your AI coder will:
1. Create the bot code
2. You review and run it: `python bot.py`
3. Test in Slack - say "hello" and see it respond
## Available Tools
| Tool | Command |
|------|---------|
| Python | `python3` |
| Package manager | `uv add slack-bolt` |
| opencode | `opencode` (pre-installed) |
| Install more tools | `nix profile install nixpkgs#go` |
### AI Coding Tools (install your choice)
```bash
# Claude Code
npm install -g @anthropic-ai/claude-code
claude auth # then: claude "your prompt"
# Google Gemini
npm install -g @google/gemini-cli
gemini
# OpenAI Codex
npm install -g @openai/codex
codex
```
## Slack Tokens
Already configured in your environment:
```bash
echo $SLACK_BOT_TOKEN # Bot identity
echo $SLACK_APP_TOKEN # Socket Mode connection
```
## Quick Reference
```bash
# Start a new project
mkdir ~/projectname && cd ~/projectname
uv init
uv add slack-bolt
# Run your bot
python bot.py
# Get AI help (whichever you installed)
claude "add a dice roll command to my bot"
opencode "add a dice roll command"
# Install Go (example)
nix profile install nixpkgs#go
go version
```
## Need Help?
- Your AI coder: `claude "how do I..."` / `opencode` / `gemini`
- Slack Bolt docs: https://slack.dev/bolt-python/
---
*Server: 45.77.205.49 | User: dan*