user changes

Author: ammario

docs/agentic-git-identity.md

@@ -6,7 +6,6 @@ Configure cmux to use a separate Git identity for AI-generated commits, making i
 - Preventing (accidental) destructive actions
 - Enforcing review flow, e.g. preventing AI from merging into `main` while allowing humans
 
-
 ## Setup Overview
 
 1. Create a GitHub account for your agent (e.g., `username-agent`)
@@ -98,124 +97,3 @@ git config --global --add credential.helper '!gh auth git-credential'
 ```
 
 ⚠️ **Warning**: The "replace all" approach will disable platform keychain helpers and may break Git authentication for non-GitHub remotes (GitLab, Bitbucket, etc.).
-
-### Authenticate with Your Token
-
-```bash
-gh auth login --with-token <<< "your_token_here"
-```
-
-Or interactively:
-
-```bash
-gh auth login
-# Select: GitHub.com
-# Select: HTTPS
-# Select: Paste an authentication token
-# Paste your token
-```
-
-### Verify Configuration
-
-Check that authentication is working:
-
-```bash
-# Check git config
-git config --show-origin --get-all credential.helper
-
-# Check gh authentication
-gh auth status
-
-# Test repository access
-gh repo view owner/repo
-```
-
-## Verification
-
-Create a test commit to verify the identity:
-
-```bash
-echo "test" > test-identity.txt
-git add test-identity.txt
-git commit -m "🤖 Test agent identity"
-git log -1 --format=full
-```
-
-You should see your agent name and email as both author and committer:
-
-```
-commit abc123...
-Author: Your Name (Agent) <yourname+ai@example.com>
-Commit: Your Name (Agent) <yourname+ai@example.com>
-
-    🤖 Test agent identity
-```
-
-## Troubleshooting
-
-### Push Fails with "Repository not found"
-
-The token might not have access to the repository:
-
-- Verify the token has `repo` scope
-- For private repos, ensure the agent account has access to the repository
-- Try: `gh repo view owner/repo` to test access
-
-### Push Uses Wrong Credentials
-
-System keychain might be overriding `gh` credentials:
-
-- Verify git credential config: `git config --show-origin --get-all credential.helper`
-- If you used `gh auth setup-git`, it should be properly scoped to GitHub
-- If you manually configured, ensure the credential helper is either:
-  - Scoped: `credential.https://github.com.helper`
-  - Or global with reset: empty helper `""` comes before `!gh auth git-credential`
-- Clear keychain credentials if needed (macOS): Delete github.com entry from Keychain Access
-
-### Author and Committer Differ
-
-Missing `GIT_COMMITTER_*` secrets:
-
-- Ensure all four secrets are set in Project Secrets: `GIT_AUTHOR_NAME`, `GIT_AUTHOR_EMAIL`, `GIT_COMMITTER_NAME`, `GIT_COMMITTER_EMAIL`
-- Click "Save" in the secrets modal
-- Restart cmux to pick up the changes
-- Test by running a git command via the agent and checking the commit
-
-### Changes Don't Take Effect
-
-Secrets not being applied:
-
-- Verify the secrets are saved in the Project Secrets modal
-- Restart cmux to ensure the config is reloaded
-- Test with a simple bash command: `echo $GIT_AUTHOR_NAME` via the agent
-- Ensure you're working in the correct project (secrets are project-scoped)
-
-## Best Practices
-
-- **Commit prefixes**: Use 🤖 emoji or `[AI]` prefix in commit messages
-- **Token security**: Never commit tokens to repositories
-- **Token rotation**: Rotate tokens periodically for security
-- **Repository access**: Only grant access to repositories the agent needs
-- **Documentation**: Update team docs about AI-generated commits
-
-## Reverting to Personal Identity
-
-To switch back to your personal identity:
-
-**For cmux projects:**
-
-1. Open the Project Secrets modal (🔒 icon)
-2. Remove the four Git identity secrets
-3. Click "Save"
-4. Restart cmux
-
-Commits will now use your default Git identity from `~/.gitconfig`.
-
-**For GitHub authentication:**
-
-Switch to your personal GitHub account:
-
-```bash
-# Switch to different GitHub account
-gh auth switch
-```