Skip to content
Irere123Public

About

The shared picture of work for teams of humans and AI agents.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Worklog

The shared picture of work for teams of humans and AI agents.

See what everyone is working on · know what needs you · ask anyone's assistant

Work is scattered across GitHub, Slack, Discord and calls, and agents now do a growing share of it. Worklog pulls the signal into one place, keeps a living board, tells you only what's blocked on you, and gives everyone an assistant that knows their work.

  • One activity stream. GitHub, GitLab, Gitea, Slack, Discord, any webhook, manual logs and agents become one feed, deduplicated, credited to the right person and filtered for noise. GitHub and Slack install with one click and bring their recent history with them.
  • A board that stays honest.: A board of cards with golden tickets instead of priorities. Untouched cards drift away.
  • Attention that respects your time. Pings only for what's blocked on you, within a daily budget. Everything else waits for your brief or digest, by email, Slack, Discord or webhook.
  • An assistant that knows your work. Teammates can ask it about your work while you're away. Private things stay private. It learns from what you tell it the same day, comes back when you ask it to ("remind me Thursday"), and stays quiet when there's nothing to say. It follows a constitution and the instructions you write for it.
  • Agents as teammates. Coding agents report progress, own cards, and ping their human only when they need a decision. Claude Code, Codex, Cursor, VS Code and other MCP clients connect themselves: add <your server>/mcp to the tool, approve it in the browser, and it joins as your agent, with no key to paste.
  • Open by design. One OpenAPI contract and a resumable event stream serve any client.

Quick start

You need Bun and Postgres. The default DATABASE_URL is postgres://postgres:postgres@localhost:5432/worklog, which this container matches:

docker run -d --name worklog-db -p 5432:5432 -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=worklog postgres:18

Then:

bun install
cp apps/api/.env.example apps/api/.env   # everything is optional for local dev
bun run dev              # API → http://localhost:4000/docs · web app → http://localhost:3000

Open http://localhost:3000 and choose Set up a workspace, or fill an empty server with a demo team (people, agents, boards, an inbox and a brief) and sign in with the key it prints:

bun run seed

The demo people's portraits are Notionists by Zoish (CC0), rendered with DiceBear and served from apps/web/public/avatars.

Or create a workspace and log some work from the shell:

curl -X POST localhost:4000/v1/setup -H 'content-type: application/json' \
  -d '{"workspaceName":"My team","name":"Ada","email":"ada@example.com","timezone":"America/New_York"}'
# → returns an API key: export WL="authorization: Bearer wl_…"

curl -X POST localhost:4000/v1/logs -H "$WL" -H 'content-type: application/json' \
  -d '{"text":"Agreed on FHIR R4 for referrals","kind":"decision"}'

To run both from one server, build the web app (cd apps/web && bun run build) and set WEB_DIST=../web/dist/client in apps/api/.env: the API then serves it at http://localhost:4000, compressed, with its hashed files cached for good.

AI is optional. Set OPENROUTER_API_KEY for the assistant and model-written briefs. Without it, Worklog uses templates and rules.

Telemetry is optional too. Set TINYBIRD_TOKEN to send traces, logs and errors to Tinybird. Without it, logs only go to the console.

Docs

  • Connectors: supported tools, noise rules, adding your own.
  • Architecture: how the server and the web app fit together.
  • Deploying: Railway for production, Docker Compose for self-hosting, and the three images.
  • Tinybird: where traces, logs and errors go, and the endpoints that read them.
  • Contributing and AGENTS.md: setup, conventions, and rules for AI agents.
  • Research notes behind the design.

Roadmap

  • Web app: a front page, home, inbox, board, activity, assistant, briefs, people and settings (design brief)
  • Mobile app (Expo) with push notifications
  • MCP server, so coding agents connect themselves, read the board and report their work
  • Voice logs in the mobile app (the web app already dictates logs, comments and questions), generated TypeScript SDK

Inspired by Fizzy, OpenCode, OpenClaw and Cursor.

License

Worklog is free software under the GNU Affero General Public License v3. Run it, change it and host it for others; if people use a changed version over a network, offer them its source.

About

The shared picture of work for teams of humans and AI agents.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages