aboutsummaryrefslogtreecommitdiff
path: root/CLAUDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md33
1 files changed, 30 insertions, 3 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index 4336c20..f92eb34 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -63,10 +63,10 @@ just clean
### Token Management
```bash
# Generate new authentication token
-go run cmd/tokentool/main.go -generate -name <username>
+TMPDIR=/tmp/go-build go run cmd/tokentool/main.go -generate -name <username>
# List existing tokens
-go run cmd/tokentool/main.go -list
+TMPDIR=/tmp/go-build go run cmd/tokentool/main.go -list
# Generate token directly from main binary
./main -g
@@ -80,6 +80,21 @@ go run cmd/tokentool/main.go -list
- **Linting**: Uses golangci-lint
- **Build System**: Uses `just` (justfile) for task automation
- **Container**: Designed for Kubernetes deployment with minimal dependencies
+- **TMPDIR**: Use `TMPDIR=/tmp/go-build` for `go run` commands if /tmp filesystem doesn't allow executables
+
+## Large File Support
+
+For pushing large binary files (>1MB), clients need to increase git's HTTP POST buffer:
+
+```bash
+# Global configuration (recommended)
+git config --global http.postBuffer 524288000
+
+# Per-repository configuration
+git config http.postBuffer 524288000
+```
+
+This setting allows git to handle large file pushes over HTTP without timing out.
## Configuration Files
@@ -94,4 +109,16 @@ From `CONVENTIONS.md`:
- Prefer idiomatic Go code
- Minimize dependencies
- Expert-level Git and Go programming expected
-- Building a proxy server for `git-http-backend` \ No newline at end of file
+- Building a proxy server for `git-http-backend`
+
+# Workflow
+
+1. Write Tests
+2. Lint Code
+3. Commit
+4. Write Code
+5. Lint
+6. Run tests
+7. Fix Code
+8. Lint
+6. Iterate