เริ่มต้นใช้งาน

ก่อนส่ง heartbeat แรกต้องมีสามอย่างพร้อม คือ editor ที่ AtoAxis รับข้อมูลได้, CLI ที่ทำหน้าที่ส่ง heartbeat จริง และ key ที่ระบุบัญชีของคุณ ช่วง Early Access เราออก key ให้เฉพาะผู้ที่อยู่ในรายชื่อ ไม่ได้ออกให้ทันทีตอนสมัคร

• VS Code 1.90 ขึ้นไปสำหรับ extension ของเราเอง หรือ editor ใดก็ได้ที่มี WakaTime plugin อยู่แล้ว
• มี wakaclock-cli ใน PATH หรือกำหนด path เต็มไว้ที่ setting wakaclock.cliPath เพราะ extension แค่เก็บ activity แต่ไม่ได้ติดต่อ server เอง
• บัญชี AtoAxis และ API key ที่สร้างจาก dashboard
• การเชื่อมต่อ HTTPS ขาออก heartbeat ที่ส่งไม่สำเร็จจะถูกคิวไว้ที่ ~/.wakaclock/queue.db แล้วส่งใหม่ภายหลัง ข้อมูลของวันนั้นจึงไม่หาย

API key ใช้ยืนยันตัวตนของทุก heartbeat ที่เครื่องคุณส่ง key เดียวครอบคลุมทั้ง editor ทุกตัวและ AI hook ทุกตัวในบัญชีนั้น

• เปิดหน้า Settings ใน dashboard แล้วมองหาแผง API key
• กด Generate key
• คัดลอก key เก็บไว้ dashboard ยังแสดง key เดิมให้ดูได้เสมอ จึงไม่ต้อง regenerate เพียงเพื่อดูค่าอีกครั้ง
• การ regenerate จะแทนที่ key เดิมทันที เครื่องที่ยังใช้ key เก่าจะถูกปฏิเสธ

wakaclock-cli config set-key YOUR_API_KEY

คำสั่งนี้เขียน key ลง ~/.wakaclock/config.toml ซึ่งเป็นที่เดียวกับที่ CLI เก็บ user_id และ server_url ส่วน VS Code extension เก็บ key ของตัวเองไว้ใน secret storage ของ VS Code ไม่ใช่ settings.json จึงไม่ถูก commit ไปพร้อมกับ config ของ editor

VS Code กับ extension ของเราเอง

Extensions: install "AtoAxis — Developer Time Tracking"
Command Palette: Wakaclock: Set API Key
Command Palette: Wakaclock: Configure CLI Path   # only if the binary is not on PATH

ไม่ต้องตั้งค่าอย่างอื่นแล้ว การพิมพ์จะอัปเดต buffer ในหน่วยความจำ การ save จะ flush เป็น write และการสลับไฟล์จะ flush ไฟล์ที่เพิ่งออกมา

Editor อื่นผ่าน WakaTime protocol

[settings]
api_url = https://api.atoaxis.com/api/v1
api_key = your_generated_api_key

Editor ที่มี WakaTime plugin อยู่แล้วแก้แค่ไฟล์นี้ไฟล์เดียว ไม่ต้องติดตั้ง extension ของ AtoAxis เพิ่ม เพราะ AtoAxis รองรับ WakaTime heartbeat API ทำให้ plugin เดิมทำงานได้เหมือนเดิม

สองคำสั่งนี้ตอบคำถามว่า "ใช้งานได้จริงหรือยัง" คำสั่งแรกถาม server ส่วนคำสั่งที่สองถามยอดรวมของวันนี้ที่ server นับไว้ ทั้งคู่ไม่อ่านไฟล์ในเครื่อง

wakaclock-cli status   # server reachable, API key present
wakaclock-cli today    # today’s total, as the server counts it

• status bar ของ VS Code แสดงยอดเดียวกันและรีเฟรชทุก 15 วินาที
• คำสั่ง Wakaclock: Send Heartbeat Now จะ flush activity ที่ค้างอยู่ทันที ไม่ต้องรอรอบ 120 วินาทีของไฟล์เดิม
• หน้า Overview ใน dashboard จะแสดงยอดรวมทันทีที่ heartbeat แรกเข้าระบบ

ปัญหาตอนเริ่มใช้งานเกือบทั้งหมดเป็นหนึ่งในห้าข้อนี้ และแต่ละข้อมีวิธีตรวจที่บอกได้ว่าเป็นข้อไหน

• status bar ไม่ขึ้นยอดเวลา แปลว่าหา CLI ไม่เจอ ให้รัน Wakaclock: Configure CLI Path หรือกำหนด wakaclock.cliPath เป็น path เต็มของ binary
• อ่านโค้ดเฉย ๆ ไม่ถูกนับ เพราะ heartbeat เกิดจากการแก้ไข การ save และการสลับไฟล์เท่านั้น ช่วงที่ไม่มีกิจกรรมถึงเกณฑ์ idle จะไม่ถูกนับโดยตั้งใจ
• ยอดหยุดเพิ่ม ให้รัน wakaclock-cli status heartbeat ที่ยังส่งไม่สำเร็จจะค้างอยู่ใน ~/.wakaclock/queue.db และถูกส่งใหม่เมื่อกลับมาต่อ server ได้
• โปรเจกต์เดียวถูกนับสองชื่อ เกิดจาก checkout สองที่ของ repository เดียวกัน ให้รวมเข้าด้วยกันที่หน้า Settings ผ่าน project rules หรือการ merge เอง
• ไม่เห็นงานฝั่ง AI ให้รัน AtoAxis: Show AI Tracking Status แล้วรัน AtoAxis: Set Up AI Tracking เพื่อติดตั้ง hook ของ Claude Code, Codex CLI หรือ Gemini CLI ส่วน Cursor และ Copilot ยังไม่มี adapter