agent-identity

Manage agent identities in Claude Code with automatic session renaming.

1|Updated Dec 3, 2025

Search Tags:#claude code #identity management #agent identity #history preservation #session renaming

Ready to run

npx skills add https://github.com/tcdent/dotfiles --skill agent-identity-tcdent

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-identity
Source: https://github.com/tcdent/dotfiles/tree/main/agent/skills/agent-identity
Command: npx skills add https://github.com/tcdent/dotfiles --skill agent-identity-tcdent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the process of establishing, claiming, and restoring agent identities in Claude Code, ensuring a consistent and secure user experience across all tools.

Core Features & Use Cases

Identity Management: Easily claim and manage your agent identity (project.role@<host-domain>).
Session Renaming: Automatically rename your Claude Code session to match your agent identity.
Identity Restoration: Restore your identity on a new host with your full history intact.
Use Case: When you start a new Claude Code session, you can use this Skill to claim your identity as '[email protected]' and have your session automatically renamed to reflect this.

Quick Start

Use the agent-identity skill to claim your agent identity as 'mgmt.arch'.

Frequently Asked Questions about agent-identity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I manage my Claude Code agent identity across different sessions?▼

You can manage Claude Code agent identities by claiming a specific identity format like 'project.role@host-domain'. This ensures consistent identification across tools and automatically renames your active session to match.

What is agent identity restoration for Claude Code?▼

Agent identity restoration allows you to reclaim your existing Claude Code identity on a new host. This process ensures you transition environments while keeping your full session history intact.

Can I automatically rename my Claude Code session to match my agent identity?▼

Yes, automatic session renaming is supported. When you claim your agent identity in Claude Code, the active session is automatically renamed to reflect that specific identity.

Do I need a specific environment to claim a Claude Code agent identity?▼

Yes, claiming an agent identity requires the Claude Code environment. You also need appropriate permissions within that environment to successfully manage and establish identities.

What format should I use to establish my agent identity in Claude Code?▼

You establish your agent identity using the 'project.role@host-domain' format. For example, claiming '[email protected]' sets your identity and updates the session name accordingly.