Skip to content

🐛 git add timeout when running T3 from home directory #1227

@mokbhai

Description

@mokbhai

Problem

When running npx t3 from the home directory (e.g., /Users/mokshitjain), the checkpoint system fails with a timeout error:

Error: Git command failed in CheckpointStore.captureCheckpoint: git add -A -- . (/Users/mokshitjain) - git add -A -- . timed out.

This happens because the home directory contains thousands of files and directories (Applications/, .npm/, .cache/, .cargo/, etc.), making git add -A -- . extremely slow and causing it to exceed the 30-second timeout.

Steps to Reproduce

  1. Open terminal in home directory (~)
  2. Run npx t3
  3. Start a conversation or make any action that triggers a checkpoint
  4. Observe timeout error in logs

Expected Behavior

Checkpointing should either:

  • Skip gracefully for home directories with a warning
  • Or prevent checkpointing from home directories entirely

Actual Behavior

Git command times out after 30 seconds, causing checkpoint capture to fail and potentially disrupting the session.

Suggested Solution

Detect when the cwd is the user's home directory and skip checkpointing with a clear warning. The checkpoint system is designed for project-level work where git repositories have a manageable number of tracked files—not for entire home directories.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions