Cyberboss provides an agent bridge that integrates local coding runtimes (Codex, Claude Code) directly into WeChat, acting as a time-aware, context-persistent accountability companion. It is designed for individuals with ADHD or anyone requiring strong external accountability, addressing the failure of traditional productivity tools by assuming users may drift and transferring the regulatory layer to an always-on local agent. The primary benefit is enhanced self-discipline through proactive, inescapable supervision embedded within a daily communication tool.

How It Works

Cyberboss connects a local Codex or Claude Code runtime to WeChat via an HTTP bridge. It captures inbound messages, stamping them with precise local timestamps to reconstruct a structured "Ledger of Life" from fragmented chat, detailing event durations. A "Stochastic Pulse" mechanism allows the agent to wake at random intervals to decide on actions like messaging, writing, or updating the timeline. Reminders function as instructions for the agent's future self, and a "Zero-Token Diary" enables local note-taking without external services or burning model context. This approach shifts accountability from the user's potentially unreliable executive function to a persistent, local agent.

Quick Start & Requirements

• Primary install: Clone the repository (git clone https://github.com/WenXiaoWendy/cyberboss.git), navigate to the directory (cd cyberboss), and run npm install.
• Prerequisites: Node.js version 22 or higher, a locally installed Codex or Claude Code runtime, and Chrome/Chromium/Edge browsers are required for screenshot features.
• Configuration: Environment variables (e.g., CYBERBOSS_USER_NAME, CYBERBOSS_ALLOWED_USER_IDS, CYBERBOSS_WORKSPACE_ROOT) must be configured before the first command.
• Links: User Guide, Agent Guide, Local Data, and FAQ are available within the repository structure.

Highlighted Details

• Omniscient Time: All inbound WeChat messages are locally timestamped, providing the model with a precise view of the user's day.
• Ledger of Life: Reconstructs fragmented chat conversations into a structured personal timeline, detailing event start/end times and durations.
• Stochastic Pulse: The agent autonomously decides its next action at random intervals, rather than relying on fixed schedules.
• Zero-Token Diary: Enables writing daily traces to local files, avoiding reliance on cloud services or consuming model context.
• Timeline Functionality: The core "ledger of life" component is available as a separate, independent project (WenXiaoWendy/timeline-for-agent).

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap are provided in the README.

Licensing & Compatibility

This project is released under the AGPL-3.0-only license. This strong copyleft license requires that any modifications or derivative works offered to users over a network must also be provided under the AGPL terms, making it incompatible with closed-source commercial services that incorporate the code.

Limitations & Caveats

The project is intended for local-first personal deployment and handles highly sensitive personal data. The AGPL-3.0-only license restricts its use in closed-source cloud services. The README notes that the local Claude window functions best as a listener for the shared thread, and users should avoid running multiple cyberboss bridge processes concurrently or backgrounding the main bridge process (npm run shared:start).