# Welcome to the Dev Server

You have shell access to a shared NixOS development server.

See [./SERVER.md](./SERVER.md) for system capabilities, limits, and available tools.

## Quick Start

```bash
# Install an AI coding tool
bun install -g @anthropic-ai/claude-code   # Claude
bun install -g @google/gemini-cli          # Gemini

# Authenticate and start
claude   # or: gemini
```

## What's Here

| File | Purpose |
|------|---------|
| `~/AGENTS.md` | Guide for AI coding agents (capabilities, limits) |
| `~/README.md` | This file |
| `~/.forgejo-credentials` | Git server login (delete after first use) |

## Git Access

Clone repositories from our Forgejo server:

```bash
git clone forgejo@git.clarun.xyz:owner/repo.git
```

Web UI: https://git.clarun.xyz

See `docs/forgejo-collaboration.md` in any repo for collaboration workflows.

## Available Tools

**Pre-installed:** python3, uv, bun, node, git, vim, curl, tmux, zig

**Install more:**
```bash
bun install -g <package>           # JS/TS packages (fast)
nix profile install nixpkgs#<pkg>  # System packages
uv pip install <package>           # Python (use venv first)
```

## Limits

This is a shared server with per-user resource limits:
- ~1GB memory
- 200 processes max
- Rate-limited network

Heavy processes may be killed automatically. See [./SERVER.md](./SERVER.md) for details.

## Getting Help

- Check `~/AGENTS.md` for what's possible
- Ask in the team chat
- `nix search nixpkgs <name>` to find packages