22
33This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44
5- This project requires that Balatro Game is running in the background. To run the game use the following command:
6-
7- ``` bash
8- # Basic command (may hang on crash)
9- ./balatro.sh
10-
11- # Recommended: Run with logging and startup wait
12- ./balatro.sh > balatro_game.log 2>&1 & sleep 10 && echo " Balatro started and ready"
13- ```
14-
15- ### Game Monitoring Commands
16-
17- ``` bash
18- # Check if game is running
19- ps aux | grep run_lovely_macos
20-
21- # View game logs
22- tail -f balatro_game.log
23-
24- # View monitor logs
25- tail -f balatro_monitor.log
26-
27- # Kill game process
28- pkill -f run_lovely_macos
29- ```
30-
315## Development Commands
326
337### Linting and Type Checking
@@ -65,14 +39,14 @@ pytest -v
6539 ps aux | grep run_lovely_macos
6640
6741 # Start if not running
68- ./balatro.sh > balatro_game .log 2>&1 & sleep 10 && echo " Balatro started and ready"
42+ ./balatro.sh > balatrobot .log 2>&1 & sleep 10 && echo " Balatro started and ready"
6943 ```
7044
71452 . ** Monitor game startup** :
7246
7347 ``` bash
7448 # Check logs for successful mod loading
75- tail -f balatro_game .log
49+ tail -n 100 balatrobot .log
7650
7751 # Look for these success indicators:
7852 # - "BalatrobotAPI initialized"
@@ -86,8 +60,8 @@ pytest -v
8660 - ** JSON metadata errors** : Normal for development files (.vscode, .luarc.json) - can be ignored
8761
88624 . ** Test execution** :
89- - ** Test suite** : 32 tests covering API functions and UDP communication
90- - ** Execution time** : ~ 60 seconds (includes game state transitions)
63+ - ** Test suite** : 33 tests covering API functions and UDP communication
64+ - ** Execution time** : ~ 70 seconds (includes game state transitions)
9165 - ** Coverage** : API function calls, socket communication, error handling, edge cases
9266
93675 . ** Troubleshooting test failures** :
@@ -147,4 +121,4 @@ I keep the old code around for reference.
147121### Testing Best Practices
148122
149123- ** Always check that Balatro is running before running tests**
150- - After starting Balatro, check the log to confirm successful startup
124+ - After starting Balatro, check the ` balatrobot. log` to confirm successful startup
0 commit comments