diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..78ef757
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check src/ tests/
+      - name: Type check
+        run: mypy src/openrouter_agent/
+      - name: Test
+        run: pytest tests/ -v
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..c1c9698
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,15 @@
+.PHONY: test lint typecheck check install
+
+install:
+	pip install -e ".[dev]"
+
+test:
+	pytest tests/ -v
+
+lint:
+	ruff check src/ tests/
+
+typecheck:
+	mypy src/openrouter_agent/
+
+check: lint typecheck test