AGENTS.md

1# AGENTS.md
2 
3## Development Commands
4 
5### Build
6- `make build` - Build both frps and frpc binaries
7- `make frps` - Build server binary only
8- `make frpc` - Build client binary only
9- `make all` - Build everything with formatting
10 
11### Testing
12- `make test` - Run unit tests
13- `make e2e` - Run end-to-end tests
14- `make e2e-trace` - Run e2e tests with trace logging
15- `make alltest` - Run all tests including vet, unit tests, and e2e
16 
17### Code Quality
18- `make fmt` - Run go fmt
19- `make fmt-more` - Run gofumpt for more strict formatting
20- `make gci` - Run gci import organizer
21- `make vet` - Run go vet
22- `golangci-lint run` - Run comprehensive linting (configured in .golangci.yml)
23 
24### Assets
25- `make web` - Build web dashboards (frps and frpc)
26 
27### Cleanup
28- `make clean` - Remove built binaries and temporary files
29 
30## Testing
31 
32- E2E tests using Ginkgo/Gomega framework
33- Mock servers in `/test/e2e/mock/`
34- Run: `make e2e` or `make alltest`
35 
36## Agent Runbooks
37 
38Operational procedures for agents are in `doc/agents/`:
39- `doc/agents/release.md` - Release process
40