diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..67a4775
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,21 @@
+# Compiled binary
+/nipbox
+*.exe
+
+# Nim build artifacts
+nimcache/
+build/
+*.o
+*.a
+*.so
+
+# IDE / Editor
+.vscode/
+.idea/
+*.swp
+*~
+
+# Agent / internal
+.agent/
+.claude/
+.kiro/