paceflow 0.2.1

Local-first CLI that turns AI coding session history and git metadata into engineering analytics.
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

version: "3"

tasks:
  install-profiler:
    desc: Install samply for recording a fresh process and viewing it in a browser
    cmds:
      - cargo install samply --locked

  install-live-profiler:
    desc: Install Linux perf tooling for live terminal profiling on Ubuntu/WSL
    cmds:
      - sudo apt-get update
      - sudo apt-get install -y linux-tools-common linux-tools-generic

  build-release:
    desc: Build the release binary with profiling-friendly project settings
    cmds:
      - cargo build --release

  profile:
    desc: "Profile the release binary with samply. Example: task profile -- ingest"
    deps:
      - build-release
    cmds:
      - samply record ./target/release/paceflow {{.CLI_ARGS}}

  profile-live:
    desc: "Attach perf top to an existing PID and watch live samples in the terminal. Example: task profile-live PID=12345"
    requires:
      vars: [PID]
    cmds:
      - |
        PERF_BIN="$(find /usr/lib/linux-tools -type f -name perf 2>/dev/null | sort -V | tail -n1)"
        if [ -z "$PERF_BIN" ]; then
          echo "No perf binary found under /usr/lib/linux-tools. Run: task install-live-profiler" >&2
          exit 1
        fi
        exec "$PERF_BIN" top -p {{.PID}} -g --call-graph fp