63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
# 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
|
|
|
|
SSH is pre-configured. Clone repositories from our Forgejo server:
|
|
|
|
```bash
|
|
git clone forgejo@git.clarun.xyz:owner/repo.git
|
|
```
|
|
|
|
Web UI: https://git.clarun.xyz (login with `~/.forgejo-credentials`, then delete that file)
|
|
|
|
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
|