agent-identity

Manage agent identities in Claude Code with automatic session renaming.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tcdent/dotfiles --skill agent-identity-tcdent
Or copy as Structured Prompt for Agent
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.