ChronoH — 長時間実行Agent向け時間感知フレームワーク

AI/ML
ChronoH — 長時間実行Agent向け時間感知フレームワーク

ChronoH — 長時間実行Agent向け時間感知フレームワーク

ChronoHは、長時間にわたって動作するAI Agentのための開発フレームワークです。Sledによる状態持続化、セッション／チェックポイント管理、ライフサイクルフック（Clean Stateプロトコル）や原子的なファイル操作ツール群（read/write/edit/bash）を備え、断続的な実行や再開、外部ツール実行を安全に行えます。pi-rsとの統合によりAgentとモデル間の連携も想定された設計です（約300字）。

https://github.com/jshachm/chronoh

概要

ChronoHは、長時間稼働するAI Agentに「時間感覚」を与えることを目的としたRust製フレームワークです。主にセッション管理と状態の永続化を中心に設計され、Sledという組み込み型KVデータベースを用いてAgentのイベント（初期化、チェックポイント、会話の開始・終了など）を自動記録します。ライフサイクル終了時に実行されるClean Stateプロトコルや、ファイル操作を安全に行う4つの原子的ツール（read/write/edit/bash）を提供し、途中停止後の再開（チェックポイント復元）や外部コマンド実行のタイムアウト制御、カスタムフックによる拡張性をサポートします。

GitHub

リポジトリの統計情報

  • スター数: 10
  • フォーク数: 0
  • ウォッチャー数: 10
  • コミット数: 22
  • ファイル数: 7
  • メインの言語: Rust

主な特徴

  • 状態持続化（Sledベース）でセッションの断点復帰をサポート
  • Clean Stateプロトコルによる終了前チェック（テスト／Git／進捗／引継ぎ）
  • 原子的なファイル操作ツール群（read/write/edit/bash）で安全なI/Oと外部コマンド実行
  • フック設計によりカスタム検査・拡張が可能、pi-rsとの統合でモデル連携を想定

技術的なポイント

ChronoHの技術的核は「耐久性の高いセッション管理」と「終了時の健全性保証」にあります。Sledを採用することで、簡易なキー・バリュー方式でイベントやセッションステートを高速かつ永続的に格納できます。各会話／作業セッションは明示的に開始・終了され、チェックポイントを切っておくことでプロセス中断からの再開が容易になります。Clean Stateプロトコルはライフサイクルの最後に自動実行される一連の検査で、単に状態を保存するだけでなく「その時点でプロジェクトが次に引き継げるか」を判定します。具体的にはユニットテストの合格、Gitワーキングツリーのクリーンさ、進捗メタ情報の更新、引き継ぎドキュメントの生成といったチェックを行い、不備があればフックを通して追加処理やロールバックが可能です。

ファイル操作に関しては4つの原子ツール（read/write/edit/bash）を提供します。readは(offset/limit)で部分読み出しを行い、writeは原子的にファイルを書き換え、editは狙った範囲の文字列置換を行うことで競合を避けます。bashは外部シェルコマンドを安全に実行でき、実行時間のタイムアウト制御や標準入出力の取り扱いが組み込まれている想定です。これらはAI Agentがファイルを直接操作したり、ビルドやテストを外部プロセスで行うワークフローに対して、安全性と再現性を提供します。

また、設計はフックベースで拡張しやすく、カスタムの検査ロジックや通知、外部サービス連携を追加できます。READMEにある通りpi-rsとの統合も視野に入れており、LLMやモデル層とのやり取りを組み込んだ長時間タスクのオーケストレーションが想定されています。Rustで書かれているため低レベルの安全性と性能を両立でき、組み込みKVや原子的IOとの相性が良い設計です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • Cargo.lock: file
  • Cargo.toml: file
  • README.md: file
  • docs: dir

…他 2 ファイル

まとめ

長期実行Agentのステート管理と終了時保証に特化した、拡張性の高いRust製フレームワークです（50字）。

リポジトリ情報：

READMEの抜粋：

ChronoH ⏰

为长时间运行的 AI Agent 提供时间感知能力的开发框架

概述

ChronoH 是一个专为 AI Agent 设计的时间感知开发框架，通过状态持久化、生命周期钩子和会话管理，帮助 AI Agent 实现可靠的长时间开发任务。

核心特性

🗄️ 状态持久化

  • 基于 Sled 嵌入式 KV 数据库
  • 自动记录所有开发事件（初始化、检查点、会话开始/结束）
  • 支持断点续传，会话状态不丢失

🔄 生命周期钩子

  • Clean State 协议：每次会话结束前自动检查
    • 测试是否通过
    • Git 仓库是否干净
    • 进度是否更新
    • 交接文档是否生成
  • 可扩展的钩子系统，支持自定义检查逻辑

🛠️ 4-原子工具

  • read: 读取文件（支持 offset/limit）
  • write: 原子写入文件
  • edit: 精确替换文本
  • bash: 执行 Shell 命令（支持超时控制）

👥 角色化 Agent

  • Initializer: 项目初始化，创建…