88 lines
1.9 KiB
Markdown
88 lines
1.9 KiB
Markdown
# 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
|
|
bun, node, npm # JS/TS dev (bun preferred - faster)
|
|
zig # Zig compiler
|
|
git, vim, curl, tmux # Basics
|
|
opencode, bd # AI coding tools
|
|
```
|
|
|
|
## Installing Packages
|
|
|
|
**JS packages** (gemini-cli, etc.) - use bun for faster installs:
|
|
```bash
|
|
bun install -g @google/gemini-cli
|
|
bun install -g @anthropic-ai/claude-code
|
|
```
|
|
|
|
**Nix packages** (go, rust, etc.):
|
|
```bash
|
|
nix profile install nixpkgs#go
|
|
nix profile install nixpkgs#rustc
|
|
nix profile list # See installed
|
|
nix profile remove <n> # Remove by index
|
|
```
|
|
|
|
**Python packages**:
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# Check what's installed
|
|
which <tool>
|
|
nix profile list
|
|
|
|
# Search for packages
|
|
nix search nixpkgs <name>
|
|
|
|
# Check resource usage
|
|
htop
|
|
```
|