# Oubliette

SSH honeypot written in Go. See `PLAN.md` for full project plan and architecture.

## Development

- **Nix devshell:** Always use `nix develop -c` to run commands, e.g. `nix develop -c go test ./...`, `nix develop -c golangci-lint run`.
- **Tech stack:** Go, SQLite, x/crypto/ssh, Go templates + htmx for web UI. Single binary with embedded assets.

## Guidelines

- Write tests for all important functionality.
- Update `README.md` when new features are added. Keep entries concise for minor stuff.
- Keep code simple and focused. Refer to `PLAN.md` for design decisions.
- When adding new config options, always add them to `oubliette.toml.example` as well.

## Git workflow

- Use **conventional commits** (e.g. `feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `chore:`).
- Check out a **feature branch** before starting work on a new feature.