spm4a

A pm2-style process manager for Spring Boot apps, built for agentic coding.

面向 Agentic Coding 的 Spring Boot 进程管理器（类 pm2）：Go 实现，单一二进制， CLI + daemon + TUI 三形态——Agent 经 CLI 启动 / 调试 / 测试应用，人类开发者用 TUI 观察与操作。支持 Windows / Linux / macOS。

特性

• daemon 按需自动拉起，CLI 经命名管道（Windows）/ Unix Socket 通讯（HTTP + JSON-RPC 2.0）
• namespace 隔离：同一项目检出支持多会话并行，互不干扰
• 随机端口分配；actuator 就绪检查与优雅停机；devtools 热重启（spm4a reload）
• 多 JDK 注册表与按 app 指定（spm4a jdk scan）；JDWP 调试注入（--debug）
• JVM 参数直配（xms / xmx / jvm-opts）；jar / maven / gradle / custom 四种启动方式
• bubbletea TUI（spm4a tui）；全部命令支持 --json 与稳定退出码

快速开始

go build -o spm4a ./cmd/spm4a        # 或下载 release 二进制

spm4a start -f spm4a-app.yaml        # 启动（配置文件见 docs/design.md §6）
spm4a ls                             # 查看
spm4a logs -f my-app                 # 跟随日志
spm4a tui                            # 仪表盘

配置示例

spm4a-app.yaml

namespace: mall                  # 可选，缺省探测（git 根目录 > 构建文件 > default）
apps:
  - name: order-service          # 可选，缺省取 workdir 目录名
    workdir: services/order      # 必填；相对路径相对本文件所在目录
    launcher: jar                # jar | maven | gradle | custom
    jar: target/*.jar            # launcher=jar；绝对路径 | 相对 workdir | glob（须唯一命中）
    command: ["./run.sh"]        # launcher=custom 时使用
    jdk: "17"                    # JDK 绝对路径 | 注册表名 | major 版本号（建议加引号）
    port: random                 # random | 8080
    debug: true                  # true=随机调试端口 | 5005 | false
    env: { SPRING_PROFILES_ACTIVE: dev }
    args: ["--my.flag=x"]        # 应用参数，永远赢过自动注入
    health-path: /actuator/health
    shutdown-timeout: 15s
    restart-policy: never        # never | on-failure | always
    ephemeral: false             # 缺省 true：stop 后不保留记录（收养不受影响）；长驻应用显式 false
    log-file: ./logs/${name}.log # 缺省即此；支持 ${name} ${namespace} ${workdir} ${pid} ${ts}
    xms: 64M                     # 缺省 32M；"" 关闭注入
    xmx: 512M                    # 缺省 256M；"" 关闭注入
    jvm-opts: ["-XX:TieredStopAtLevel=1"]