Dan 3c8f961cdc docs: user-facing docs with SERVER.md symlink pattern

- SERVER.md: symlinked from /etc/user-docs (always current)
- AGENTS.md: user's file, points to SERVER.md, editable
- README.md: welcome doc, copied once
- readme.txt: whaddup cuz

dev-add.sh provisions all four, only overwrites SERVER.md symlink.

2026-01-22 22:04:51 -08:00

1.4 KiB

Raw Blame History

Welcome to the Dev Server

You have shell access to a shared NixOS development server.

See ./SERVER.md for system capabilities, limits, and available tools.

Quick Start

# 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:

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:

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 for details.

Getting Help

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

1.4 KiB Raw Blame History