Colophon runs in Chrome and Firefox alongside Google Docs. It records AI writing interactions as a TWFF-compatible process log: what was written, when AI assistance was used, and what the author decided to do with each suggestion (accept, modify, or reject). The author exports and submits the log voluntarily.
The .twff file is a structured JSON log that shows the writing process
Full format specification: TWFF spec Live demo of the desktop editor: firl.nl/twff
- #1 Manifest V3 scaffold
- #2 Session lifecycle
- #3 Edit event capture
- #4 Popup UI
- #5 Local JSON export →
.twff
- Ollama integration: llamafile should also be tested as alternative
- Side panel scaffold
ai_interactionevent schema- SHA-256 hash chain for integrity verification
- Detect Gemini native suggestions in Google Docs DOM
- Gemini API test
- Google Drive save option
- Chrome Web Store setup
- Settings page
- Side panel polish
- Internal beta
- Chrome Web Store submission
- User-facing README: install, first use, privacy, TWFF export
| Milestone | Target date | Status | Output | Actual date |
|---|---|---|---|---|
| Sprint 1 complete | May 10 | [in progress] | Extension can produce a valid .twff export | |
| Sprint 2 complete | May 24 | [ ] | Ollama ai_interaction recorded | |
| Sprint 3 complete | Jun 7 | [ ] | Gemini detected; Drive save working | |
| Internal beta | Jun 14 | [ ] | test, no critical bugs | |
| Store submission | Jul 5 | [ ] | Passing Chrome review | |
| Case study beta | Jul 2025 | [ ] | Deployed at uni site |
git clone https://github.com/Functional-Intelligence-Research-Lab/colophon
cd colophon
npm install
npm run build # produces dist/Load unpacked extension in Chrome:
- Go to
chrome://extensions - Enable Developer mode
- Click Load unpacked
- Select the
dist/folder
During development, use npm run watch instead of npm run build — it rebuilds on every save. Reload the extension in chrome://extensions after each rebuild.
To validate a .twff export:
python tools/validate.py path/to/your-session.twffRead CONTRIBUTING.md.
Apache-2.0. See LICENSE.
Contributions are credited in the repository and in any publications using Colophon as a research instrument.