tissue init

Initialize tissue issue tracking in a git repository.

Tissue Command

tissue init

Manual Workflow (bash + git)

Basic initialization

Assumed starting in an existing repo with a remote origin configured

# Create orphan branch for issues
git checkout --orphan issues

# Clear the index
git rm -rf . 2>/dev/null || true

# Create initial README for the issues branch
cat > README.md << 'EOF'
# Issue Tracker

This branch contains all issues for this repository.
Each issue is a markdown file with YAML frontmatter.
EOF

# Create a .gitignore for the issues branch
cat > .gitignore << 'EOF'
# Ignore everything except issues directory
/*
!/*.md
!/.gitignore
EOF

# Commit the initial structure
git add .gitignore README.md
git commit -m "Initialize issues branch for issue tracking"

# Push to remote (if exists)
git push -u origin issues

# Return to main branch
git checkout main

With worktree setup

# Set up a worktree for the tissues branch
git worktree add issues issues

# Now you can access issues without switching branches
ls -la issues

# Add to main branch .gitignore
echo "issues/" >> .gitignore
git add .gitignore
git commit -m "Add issues worktree to gitignore"

Verify setup

# Check that tissues branch exists
git branch -a | grep issues

# Check worktree status
git worktree list

# Verify you can access issues
ls -la issues

What tissue does for you:

1. Automates the creation of the orphan branch
2. Sets up the proper directory structure
3. Creates default templates and configuration
4. Handles worktree setup if requested
5. Ensures proper .gitignore configuration
6. Validates the setup is correct