Agent Logs

Session log collection for Claude Code. Your logs help Chiba Tech provide better evaluation and feedback on your projects.

Getting Started

Install the agent-logs CLI to start sharing your Claude Code session logs with Chiba Tech.

Prerequisites

You need Claude Code installed. Your Claude account email will be detected automatically.

  1. Install the CLI

    Open a new terminal window, or reload your shell config after installing:

    curl -fsSL https://agent-logs.chibatech.dev/install.sh | bash
    source ~/.zshrc
  2. Launch Claude Code

    Navigate to your project directory and run claude. On first launch you'll be asked to verify your email — a code will be sent to your Claude account email.

    cd ~/projects/my-project
    claude
    ────────────────────────────────────────────────────
    Agent Logging Authentication

    Verification code sent to tanaka@chibatech.ac.jp
    Enter the 6-digit code from your email: 123456
  3. Sign the informed consent form

    Before Claude will launch, you must read and sign the informed consent form on the Participant Portal. The form explains how your session logs are used for educational evaluation and (optionally) research.

    ────────────────────────────────────────────────────
    Agent Logs — Consent Required

    You must sign the informed consent form before using Claude.
    Visit the portal to read and sign:

      https://agent-logs.chibatech.dev/portal.html

    Logged in as tanaka@chibatech.ac.jp
    ────────────────────────────────────────────────────
  4. Choose whether to share this folder

    A consent dialog will appear before Claude starts. Use the arrow keys to select and press Enter. You'll only be asked once per folder.

    ────────────────────────────────────────────────────
    Agent Logging Consent

    Share session logs for this workspace?
    /Users/tanaka/projects/my-project

    ❯ 1. Yes, share this folder
      2. No, don't share

    Enter to confirm · Esc to cancel
  5. Use Claude Code as normal

    Session logs sync automatically in the background. A status line at the bottom of Claude shows your current sharing state. You can ask Claude to change the share status of your project anytime.

What gets shared?

Your prompts, Claude's responses, and tool call names. File contents from tool results and file snapshots are never shared — they are stripped before leaving your machine.

Session logging from Claude Cowork, Claude Desktop and the claude.ai web chat interface are not supported yet. If you'd like to share session logs, please use Claude Code CLI.

Uninstalling

To remove agent-logs completely, open a new terminal window or reload your shell config after uninstalling:

agent-logs uninstall
source ~/.zshrc