Dan 74cf842afd Improve dev onboarding: devs group, npm setup, AGENTS.md

- Add users.groups.devs for shared resources
- dev-add: check devs group exists before creating user
- dev-add: use .profile for login shell PATH setup
- dev-add: configure npm prefix and .npm-global directory
- dev-add: create AGENTS.md with friendly capability guide
- Update onboarding message with npm install examples
- Add docs/server-AGENTS.md for reference

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-03 17:11:03 -08:00

1.8 KiB

Raw Blame History

AGENTS.md - Dev Server Guide

Guidelines for AI coding agents on ops-jrz1.

Environment

OS: NixOS (not Ubuntu/Debian - no apt)
Shell: bash
Home: /home/<username> (private, 700)

Available Tools

System-wide (ready to use):

python3, uv          # Python dev
node, npm            # JS/TS dev
git, vim, curl, tmux # Basics
opencode, bd         # AI coding tools

Installing Packages

npm packages (gemini-cli, etc.):

npm install -g @google/gemini-cli
npm install -g @anthropic-ai/claude-code

Nix packages (go, rust, etc.):

nix profile install nixpkgs#go
nix profile install nixpkgs#rustc
nix profile list        # See installed
nix profile remove <n>  # Remove by index

Python packages:

uv venv && source .venv/bin/activate
uv pip install <package>

Resource Limits

Per-user limits are enforced:

Memory: 50% of system (~1GB)
Processes: 200 max
Network: 30 new connections/min (burst 60)

If you hit limits, your processes may be killed. Design accordingly.

File Locations

Path	Purpose
`~/.npm-global/`	npm global packages
`~/.nix-profile/`	nix profile packages
`~/.config/`	App configs (claude, etc.)
`/tmp/`	Temp files (fast, cleared on reboot)

Networking

Outbound connections are logged and rate-limited
No inbound ports (use SSH tunnels for local services)
Example tunnel: ssh -L 8080:localhost:8080 dev-server

Do NOT

Run sudo (you don't have access)
Install with apt or yum (this is NixOS)
Fork-bomb or stress test (watchdogs will kill you)
Store secrets in plain files (use env vars)

Getting Help

# Check what's installed
which <tool>
nix profile list

# Search for packages
nix search nixpkgs <name>

# Check resource usage
htop

1.8 KiB Raw Blame History