Repolode
Submit
ruiwang20010702

ruiwang20010702/foursday

A personal-memory-driven AI work twin that receives DingTalk messages and uses Codex to do project work in real local workspaces.

View on GitHubWebsite
Stars
95
Forks
2
Open issues
0
Last commit
2 months ago

What is it?

Foursday is an always-on work assistant for people whose requests arrive as direct messages in DingTalk. When a verified sender in the current DingTalk organization asks for something, Foursday pulls in personal context from a gbrain knowledge store, selects a registered local workspace, and lets Codex search, edit files, run tests and recover from failures inside that workspace.

The design centers on identity, scope and delivery boundaries rather than a fixed capability checklist. Reversible work inside the selected workspace runs autonomously, long tasks are acknowledged and resumed as durable background work, and replies include read-back evidence. Pushing, merging, deployment, production writes, deletion, payments and secret disclosure are blocked or routed to the owner.

The project runs on macOS with Node.js 22+ and is built on a pinned Hermes control plane. It ships a Codex and Claude plugin that share a local Control MCP for status, tasks and schedules, plus an optional macOS desktop companion. Setup starts in send-disabled trial mode.

Key features

  • 01Accepts direct messages from verified DingTalk organization members and binds each turn to one workspace.
  • 02Lets Codex work inside registered local project workspaces with sandboxing and command rules.
  • 03Reads authorized personal gbrain pages and exact shared DingTalk document links for context.
  • 04Runs long tasks as durable background work with acknowledgement and resume after restart.
  • 05Provides Codex and Claude plugins plus a macOS desktop companion for task status.

Use cases

  • Handling routine engineering requests from teammates that arrive as DingTalk messages.
  • Letting a personal AI agent make and test reversible code changes in a local repository.
  • Tracking long-running project tasks with status visible in Codex or Claude sessions.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/ruiwang20010702/foursday.git
  2. 2

    Enter the folder and install dependencies without install scripts

    cd foursday && npm ci --ignore-scripts
  3. 3

    Run setup to check the environment and start a read-only trial

    npx --no-install foursday setup
  4. 4

    Apply the setup, which ends in trial mode with no automatic DingTalk replies

    npx --no-install foursday setup --apply

Things to know

  • Requires macOS, Git, Node.js 22+, DWS v1.0.59+ and access to a personal gbrain endpoint.
  • Setup ends in trial mode with no automatic DingTalk replies; activation is a separate decision.
  • Works only with DingTalk organization accounts and Codex, and the non-macOS path is a read-only fallback.

In collections

Open-source AI agent frameworks & appsAI coding assistants & agentsOpen-source personal AI agents

Topics

#ai-agents#personal-agent#codex#dingtalk#workplace-automation#nodejs#developer-tools#digital-twin#graph-engineering#open-source

FAQ

What is foursday?
A personal-memory-driven AI work twin that receives DingTalk messages and uses Codex to do project work in real local workspaces. Foursday is an always-on work assistant for people whose requests arrive as direct messages in DingTalk. When a verified sender in the current DingTalk organization asks for something, Foursday pulls in personal context from a gbrain knowledge store, selects a registered local workspace, and lets Codex search, edit files, run tests and recover from failures inside that workspace.
Is foursday free to use? What license does it have?
foursday is open source under the MIT license. Check the license terms before using it in commercial products.
Is foursday still maintained?
Updated within 6 months. The last commit to foursday was on Sep 3, 2026.
What can I use foursday for?
Handling routine engineering requests from teammates that arrive as DingTalk messages. Letting a personal AI agent make and test reversible code changes in a local repository. Tracking long-running project tasks with status visible in Codex or Claude sessions.
How do I install foursday?
Clone the repository: git clone https://github.com/ruiwang20010702/foursday.git Enter the folder and install dependencies without install scripts: cd foursday && npm ci --ignore-scripts Run setup to check the environment and start a read-only trial: npx --no-install foursday setup Apply the setup, which ends in trial mode with no automatic DingTalk replies: npx --no-install foursday setup --apply
Where can I get foursday?
The source code and installation instructions are on GitHub: https://github.com/ruiwang20010702/foursday

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects