blob: aa60b8f6c953e1f9961f6995f7e6ba5505a38e69 (
plain)
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
77
78
|
# FastForge - AGENTS.md
Pebble Intermittent Fasting Tracker Development Guide
Fedora Linux + Rebble Pebble SDK 4.9+ (April 2026)
This file is the primary workflow reference for FastForge contributors.
## 1. One-Time Initial Setup
```bash
sudo dnf update
sudo dnf install -y python3-pip nodejs SDL-devel dtc uv just
uv tool install pebble-tool --python 3.13
pebble sdk install latest
```
## 2. After Every Reboot - Restore uv Tool PATH
```bash
export PATH="$HOME/.local/bin:$PATH"
pebble --version
```
Optional permanent fix:
```bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
## 3. Justfile Workflow
Available commands:
- `just`: list commands
- `just dev`: build + install to emulator
- `just logs`: live logs (second terminal)
- `just kill`: stop emulator
- `just clean`: remove build artifacts
- `just rebuild`: clean + full rebuild + install
- `just quick`: quick rebuild + install
- `just screenshot`: screenshot of emulator
- `just sdk-version`: print Pebble SDK/tool version
Daily loop after reboot:
1. Restore PATH (`export PATH="$HOME/.local/bin:$PATH"`).
2. `cd /home/paul/git/fastforge`
3. `just dev`
4. In a second terminal run `just logs`
## 4. Commit Policy
Commit these project files when changed:
- `README.md`
- `AGENTS.md`
- `PLAN.md`
- `Justfile`
- `package.json`
- `wscript`
- `src/c/fastforge.c`
- `.gitignore`
Do not commit generated artifacts:
- `build/`
- `*.pbw`, `*.elf`, `*.bin`, `*.o`, `*.map`
- `.lock-waf*`, `.wafpickle*`, `config.log`
## 5. Troubleshooting
- `pebble: command not found`: restore PATH from section 2.
- Emulator does not start: run `just kill` then `just dev`.
- Build fails: run `just clean` then `just rebuild`.
- Change app version: update `package.json`, then run `just dev`.
Last updated: April 12, 2026
Maintained for: FastForge agents
|
