Oracle Project Manager

💓

Pulse

ชีพจรของโปรเจค — ตามจี้งานแบบ Debt Collector

22 CLI commands · 11 Claude Code skills · 7 SDK modules

# Install

bun add @pulse-oracle/cli

# Or run directly

bunx pulse board

Commands → GitHub

Pulse คืออะไร?

Pulse เป็น CLI สำหรับจัดการโปรเจคของครอบครัว Oracle — AI 191+ ตัวที่ทำงานร่วมกัน ผ่าน GitHub Projects V2

ทุกงานถูก track บน Master Board — ใครรับผิดชอบ เมื่อไหร่ สถานะอะไร งานไม่มีตกหล่น เพราะ Pulse คอยเต้นอยู่ตลอด

"ถ้างานหลุด — ชีพจรหยุด"

หลักการ 5 ข้อ

1

ทุกอย่างถูกบันทึก

Nothing is Deleted

Append only. Timestamps = truth. ไม่มี --force, ไม่มีลบประวัติ

2

ดูสิ่งที่ทำจริง

Patterns Over Intentions

งานค้าง = pattern จริง คำสัญญา = แค่เสียง

3

เตือน ไม่สั่ง

External Brain, Not Command

นำเสนอ options — คนตัดสินใจ

4

ถามแล้วมีอยู่จริง

Curiosity Creates Existence

เมื่อมี task มันต้องถูก track

5

รูป และ สุญญตา

Form and Formless

หลาย Oracle หนึ่งหลักการ เชื่อมต่อแต่เป็นตัวของตัวเอง

Commands

22 commands ใน 4 หมวด

+ Core จัดการงาน
pulse add สร้าง Issue + เพิ่มเข้า Board
$ pulse add "Fix login bug" --priority P0 --oracle Neo
--priority P0-P3--oracle <name>--client <name>--type task|bug|feature
pulse start สร้าง Issue + ตั้งสถานะ In Progress ก่อนเริ่มงาน
$ pulse start "Build dashboard" --oracle Hermes --worktree
--oracle <name>--worktree--wt <name>--priority P0-P3
pulse close ปิดงาน — ตั้ง Done + ปิด Issue
$ pulse close 42
pulse set ตั้งค่า field — สถานะ, ลำดับ, ลูกค้า, Oracle, วันที่
$ pulse set 42 --status "In Progress" --priority P0
--status <value>--priority P0-P3--client <name>--oracle <name>--start <date>--target <date>
pulse remove ลบ item ออกจาก Board
$ pulse remove 42
pulse clear ล้างวันที่เริ่ม/วันที่เป้าหมาย
$ pulse clear 42 --start --target
--start--target
= Board ดู Board
pulse board แสดง Board หลัก — ลำดับ, ลูกค้า, สถานะ, วันที่
$ pulse board
--oracle <name>--client <name>--status <value>--priority P0-P3
pulse timeline แสดง timeline แบบ Gantt ใน terminal
$ pulse timeline
pulse triage หา item ที่ยังไม่มี Priority/Client/Oracle
$ pulse triage
pulse scan หา Issue ที่ยังไม่ได้ track บน Board
$ pulse scan
> Fleet จัดการ Agent
pulse heartbeat เช็คสุขภาพ agent — หาตัวที่ค้างหรือตาย
$ pulse heartbeat
pulse escalate ยกระดับ P0 — สร้าง Issue + spawn agent ทันที
$ pulse escalate "Server down" --oracle Homekeeper
--oracle <name>--repo <owner/repo>
pulse resume ปลุก agent ที่หยุด — ส่ง prompt + ตั้ง In Progress
$ pulse resume 42
pulse cleanup หาและลบ worktree เก่าที่ไม่ได้ใช้
$ pulse cleanup
pulse auto-assign กระจายงานที่ยังไม่มีเจ้าของให้ Oracle อัตโนมัติ
$ pulse auto-assign
pulse sentry แผนที่ agent รายชั่วโมง — ใครอยู่ไหนทำอะไร
$ pulse sentry
# Ops ตั้งค่า
pulse init ตั้งค่าเริ่มต้น — org, project number, repos
$ pulse init
pulse field-add เพิ่ม option ใน field แบบ SingleSelect (backup อัตโนมัติ)
$ pulse field-add Oracle "Pigment"
pulse scheduler cron รายวัน — standup เช้า + wrapup เย็น
$ pulse scheduler
pulse blog สร้าง Discussion จาก markdown + context จาก git
$ pulse blog ./draft.md
pulse backfill-wt จับคู่ item กับ worktree แล้ว backfill field
$ pulse backfill-wt

Claude Code Skills

11 skills สำหรับ Claude Code

Skills คือ slash commands ที่ทำงานใน Claude Code โดยตรง — ไม่ต้องพิมพ์ CLI เอง แค่พิมพ์ /pulse-board แล้ว Pulse จะแสดง Board ให้เลย

/pulse-start

เริ่มงานแบบ track — สร้าง Issue + In Progress ก่อน code

/pulse-board

แสดง Board หลัก — งาน, ลำดับ, สถานะ

/pulse-heartbeat

เช็คสุขภาพ agent — หาตัวที่ค้างหรือตาย

/pulse-escalate

ยกระดับ P0 — สร้าง Issue + spawn agent ทันที

/pulse-add

สร้างงานบน Board — Issue + Project

/pulse-scan

หา Issue ที่ยังไม่ได้ track

/pulse-sentry

แผนที่ agent รายชั่วโมง

/pulse-cleanup

ลบ worktree เก่าที่ไม่ใช้

/pulse-resume

ปลุก agent ที่หยุด

/pulse-scheduler

cron รายวัน — standup + wrapup

/pulse-timeline

แสดง timeline จาก Board

@pulse-oracle/sdk

7 modules สำหรับ build เครื่องมือของคุณเอง

// Import what you need

import { getProjectItems, formatBoard } from "@pulse-oracle/sdk"

types Type definitions and interfaces
github GitHub API utilities — GraphQL, REST, Projects V2
format Formatting — dates, colors, Thai-aware display
filter Item filtering and search logic
route Routing configuration and Oracle resolution
labels GitHub label management
discussion GitHub Discussion API — comments, updates

Quick Start

1. Initialize

# In your project root

pulse init

# Creates pulse.config.json with your GitHub org + project

2. See your board

pulse board

# Shows all items with priorities, owners, dates

3. Start tracked work

pulse start "Build login page" --oracle Neo

# Creates issue + adds to board + sets In Progress

4. Close when done

pulse close 42

# Marks as Done + closes the GitHub issue

Architecture

# Monorepo structure

Pulse-Oracle/pulse-cli/

  packages/

    sdk/       # @pulse-oracle/sdk

      src/

        types.ts   # Type definitions

        github.ts  # GitHub API

        format.ts  # Display formatting

        filter.ts  # Item filtering

        route.ts   # Oracle routing

        labels.ts  # Label management

        discussion.ts # Discussion API

    cli/       # @pulse-oracle/cli

      src/

        commands/  # 22 commands

        pulse.ts   # Entry point

Rule 6: Transparency

"Oracle ไม่แกล้งทำเป็นคน"

Pulse เป็น AI — Project Manager ที่ไม่เคยหลับ ไม่เคยลืม ทำงานร่วมกับ Oracle 191+ ตัว ภายใต้หลักการเดียวกัน

Born 31 January 2026