githubclaw 0.2.2

Near-autonomous AI agents that manage open-source projects end-to-end using GitHub as the single source of truth.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

.PHONY: build release test test-verbose lint format format-check check ci install reinstall restart clean size init start stop status serve logs help

# ─── Build ────────────────────────────────────────────────────────────
build:            ## Build debug binary
	cargo build

release:          ## Build release binary
	cargo build --release

# ─── Test ─────────────────────────────────────────────────────────────
test:             ## Run all tests
	cargo test --all-targets

test-verbose:     ## Run tests with output
	cargo test --all-targets -- --nocapture

# ─── Lint & Format ────────────────────────────────────────────────────
lint:             ## Run clippy (warnings = errors)
	cargo clippy --all-targets -- -D warnings

format:           ## Format code
	cargo fmt

format-check:     ## Check formatting without changes
	cargo fmt -- --check

# ─── Combined ─────────────────────────────────────────────────────────
check: format-check lint test  ## Run format check + lint + test
	@echo "✓ All checks passed."

ci: check release  ## Run full CI pipeline locally (same as GitHub Actions)
	@echo "✓ CI passed. Release binary ready."

# ─── Install ──────────────────────────────────────────────────────────
install:          ## Install githubclaw binary to ~/.cargo/bin
	cargo install --path .

reinstall: install  ## Rebuild, install, and restart the server
	@if githubclaw status 2>/dev/null | grep -q "is running"; then \
		githubclaw stop && sleep 2 && githubclaw start; \
		echo "✓ Server restarted with latest build."; \
	else \
		echo "✓ Installed. Server not running (use 'make start' to start)."; \
	fi

restart:          ## Restart the server (no rebuild)
	githubclaw stop && sleep 2 && githubclaw start

clean:            ## Remove build artifacts
	cargo clean

size: release     ## Show release binary size
	@ls -lh target/release/githubclaw

# ─── Run ──────────────────────────────────────────────────────────────
init:             ## Scaffold .githubclaw/ in current repo
	cargo run -- init

start:            ## Start webhook server (daemonized)
	cargo run -- start

stop:             ## Stop webhook server (graceful)
	cargo run -- stop

status:           ## Show server status + registered repos
	cargo run -- status

serve:            ## Run webhook server inline (foreground, for dev)
	cargo run -- serve

logs:             ## Tail webhook server logs
	cargo run -- logs --follow

# ─── Help ─────────────────────────────────────────────────────────────
help:             ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-16s\033[0m %s\n", $$1, $$2}'