Skip to content

ecological-codes/scribeng

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

scribeng

The agent as scribe of its own relational history.

Agent scribe for claude.ai web sessions. Two modes: checkpoint (metadata envelope, Entire-compatible, linked to a git commit on entire/checkpoints/v1) and sessionlog (--full-log, full turn-by-turn flux record accumulated from session start). Bridges Entire CLI's Claude Code integration to the claude.ai web and sandbox environment.

Set of files

File Purpose
SKILL.md Router - load order
scribeng-SKILL.md Content - format spec, capture procedure, git operations, error recovery
scribeng.skill Packaged archive for upload to SKILL directory
.github/workflows/build-skill.yml CI workflow - auto-builds and publishes scribeng.skill on push
evals/evals.json Test cases for skill evaluation
README.md This file

Install

  • claude.ai web platform: upload scribeng.skill via skill settings. Add to any project using git repos with entire enable active.
  • Claude Code desktop app: copy contents of this folder into ~/.claude/skills/scribeng/.

When It Triggers

  • User says "capture session as Entire checkpoint", "write session to entire", "scribeng"
  • After a git commit in a session where Entire is enabled and session logging is wanted
  • Explicitly: "save this session to entire/checkpoints/v1"

What It Produces

Two metadata.json files committed to entire/checkpoints/v1, compatible with entire checkpoint list, entire session, and the entire.io web viewer:

{cid[0:2]}/{cid[2:]}/metadata.json       # session-level summary
{cid[0:2]}/{cid[2:]}/0/metadata.json     # incremental checkpoint

Where cid = first 12 hex chars of the checkpoint commit SHA. Format reverse-engineered from entire v0.6.1 (s08, 2026-05-18).

What It Does Not Do

  • Does not run entire CLI hooks (requires active Claude Code process)
  • Does not capture full transcript text (use export-memories for that)
  • Does not require Entire auth or keyring
  • Does not replace captureng - use both together

Peer Skills

  • captureng - in-session state snapshot; use alongside scribeng
  • export-memories - cross-session transcript synthesis
  • agent.md - session init; provides session_id, datetime, model context scribeng depends on

Prerequisites

  1. entire enable run in the target repo (entire/checkpoints/v1 branch must exist)
  2. At least one commit on the working branch to link the checkpoint to
  3. git-init-session.sh sourced if push to remote is needed (GIT_ASKPASS pattern)

Style Convention

Directives use the following section headers with numbered lists:

  • [RULES] - enforceable constraints applied at runtime.
  • [ACTIONS] - autonomous steps agent executes in normal workflow.

License

See LICENSE. (C) Copyright 2026 - Sameer Khan


README.md v1.0.0 - Human Approved

About

chat session logging to the maximum extent of details

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors