Agent Logs

Session log collection for Claude Code. Your logs help instructors provide better feedback on your coding process.

Getting Started

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

Prerequisites

You need a Claude seat issued by Chiba Tech. Log in to agent-logs with the same email address as your Claude account. If you don't have a seat yet, contact claude@chibatech.dev.

  1. Install the CLI
    # macOS / Linux
    curl -fsSL https://agent-logs.chibatech.dev/install.sh | bash
  2. Log in with your Claude account email

    You'll receive a verification code by email.

    agent-logs login
    Claude account email: tanaka@chibatech.dev
    Sending verification code to tanaka@chibatech.dev...
    Enter the 6-digit code from your email: 123456
    Authenticated as: tanaka@chibatech.dev
    Claude Code hooks registered.
  3. Share your coursework projects

    Navigate to each project directory and run:

    cd ~/coursework/my-project
    agent-logs consent
    Sharing enabled for: /home/tanaka/coursework/my-project
  4. Use Claude Code as normal

    Logs sync automatically after each turn. You'll see a status message at the start of each session:

    Chiba Tech — session logs are being shared
      [x] Course purposes (grading and feedback)

Managing Projects

You control which project directories are shared. Only shared projects have their Claude Code logs synced.

Commands

Command Description
agent-logs consent Start sharing logs for the current directory
agent-logs withdraw Stop sharing logs for the current directory
agent-logs doctor Check that everything is configured correctly
agent-logs logout Clear stored credentials
agent-logs uninstall Remove hooks, config, and CLI completely
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.

Withdrawing

You can stop sharing a project at any time:

cd ~/coursework/my-project
agent-logs withdraw
Sharing disabled for: /home/tanaka/coursework/my-project

Previously synced data remains on the server. To request deletion of previously collected data, contact your instructor or email claude@chibatech.dev.

Troubleshooting

Run the doctor command to diagnose issues:

agent-logs doctor

agent-logs doctor
Auth: logged in as tanaka@chibatech.dev
Hooks: registered
Projects: 2 shared, 0 withdrawn
Last sync: ok at 2026-04-07T10:30:00Z
Server: https://...run.app — ok

Common Issues

Symptom Fix
Hooks: NOT REGISTERED Run agent-logs login again to re-register hooks
Auth: NOT LOGGED IN Run agent-logs login to authenticate
Server: UNREACHABLE Check your internet connection. The server may be temporarily down.
Last sync: error Check ~/.config/agent-logs/last-sync.json for details
... is not authorized Log in with the same email as your Claude account. If you don't have a seat, contact claude@chibatech.dev.
No verification code received Check your spam folder. The email comes from claude@chibatech.dev. If still missing, try agent-logs login again.