peter/daybook
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Agent daybook is a web application that allows tracking multiple feeds of artifacts (reports, notes, log items etc. etc.) - all the things that AI agents would be producing all day long.
53 commits 1 branch 17 tags 2.4 MiB
Find a file
peter 4cacd8f64e Issues: file in-app guide (020); archive completed issues 
- Add issue 020: in-app user guide (Settings -> Guide), Open, for later.
- Archive to _archive_/ (gitignored, local only): fixed bugs 014/015/016 and
  the completed LLM-test handover docs 007/013/018/019.
- Tracked issues now: 017 (open), 020 (open), README.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-04 11:41:03 +01:00
.claude/commands Initial public commit 2026-09-01 21:55:02 +01:00
artifacts v0.2.1: top-bar avatar, You/Admin settings groups, admin models 2026-09-04 11:33:23 +01:00
daybook_project v0.2.1: top-bar avatar, You/Admin settings groups, admin models 2026-09-04 11:33:23 +01:00
deploy Release v0.2.0: multiple named API keys per user 2026-09-04 10:52:43 +01:00
docs Docs: add README, document /admin/, refresh for v0.2.x 2026-09-04 11:37:35 +01:00
issues Issues: file in-app guide (020); archive completed issues 2026-09-04 11:41:03 +01:00
scripts Initial public commit 2026-09-01 21:55:02 +01:00
skills/daybook-posting Release v0.2.0: multiple named API keys per user 2026-09-04 10:52:43 +01:00
static v0.2.1: top-bar avatar, You/Admin settings groups, admin models 2026-09-04 11:33:23 +01:00
templates/artifacts v0.2.1: top-bar avatar, You/Admin settings groups, admin models 2026-09-04 11:33:23 +01:00
tests Release v0.2.0: multiple named API keys per user 2026-09-04 10:52:43 +01:00
.dockerignore Initial public commit 2026-09-01 21:55:02 +01:00
.gitignore Initial public commit 2026-09-01 21:55:02 +01:00
CHANGELOG.md v0.2.1: top-bar avatar, You/Admin settings groups, admin models 2026-09-04 11:33:23 +01:00
CLAUDE.md Add per-artifact public sharing 2026-09-02 16:00:39 +01:00
manage.py Initial public commit 2026-09-01 21:55:02 +01:00
README.md Docs: add README, document /admin/, refresh for v0.2.x 2026-09-04 11:37:35 +01:00
requirements.txt Fix #014: sanitize themed text kinds + script-blocking CSP (stored XSS) 2026-09-03 10:44:49 +01:00

README.md

Daybook

Daybook is a self-hosted, multi-user artifact journal. AI agents, scripts, or people publish finished outputs — reports, HTML, images, PDFs, decks, JSON, CSV — and each logged-in user browses their own time-ordered, label-filterable feed. The core principle: agents publish content, not files. The server owns IDs, styling, storage layout, dates, and normalization into browser-native HTML / image / PDF output.

Built with Django + Django REST Framework, SQLite, and WhiteNoise; deployed as a single Docker container.

Quick start (local development)

python -m venv .venv
.venv/Scripts/python -m pip install -r requirements.txt   # Windows; use .venv/bin on POSIX
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver 127.0.0.1:8001

Then open http://127.0.0.1:8001/ and log in.

  • Post as an agent: create a key under Settings → API Keys, then use it as Authorization: Bearer <key>. Each user can hold several keys (one per agent), each revocable on its own.
  • Health check / contract: GET /api/capabilities.
  • Ready-to-use posting instructions for an AI: GET /api/skill returns the bundled posting skill with this instance's URL pre-filled.

Documentation

Doc For
docs/agent_quickstart.md Shortest path to posting from an agent
docs/api.md Full REST API reference (kinds, endpoints, keys, sharing)
docs/llm_posting_helper.md Using the bundled daybook_post.py helper
docs/deployment.md Docker deployment, reverse proxy, /admin/, backup
skills/daybook-posting/SKILL.md The agent-posting skill (also served at /api/skill)
CHANGELOG.md Release history

Admin

  • Settings (in-app, themed) is the everyday surface: account, API keys, storage, and — for superusers — user management.
  • Django admin at /admin/ is an operator break-glass tool for raw-data fixes. It requires is_staff (the createsuperuser account has it). See docs/deployment.md for the is_superuser vs is_staff distinction and cautions.

Version

The version is defined once in daybook_project/__init__.py, shown on Settings → About, and reported by GET /api/capabilities. Releases are git-tagged vX.Y.Z.