retoken

Sync Claude OAuth tokens from Mac Keychain to a remote server and restart Docker containers.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/leessju/claude-skills --skill retoken
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: retoken
Source: https://github.com/leessju/claude-skills/tree/main/retoken
Command: npx skills add https://github.com/leessju/claude-skills --skill retoken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mac Keychain의 Claude OAuth 토큰을 원격 서버에 동기화하고 Docker 컨테이너를 재시작합니다. 멀티 계정 슬롯을 지원합니다.

Core Features & Use Cases

  • Mac Keychain에서 Claude 토큰을 읽고 원격 서버에 동기화합니다.
  • 슬롯 0/1/2 등 멀티 계정 슬롯을 지원하며, 슬롯이 지정되지 않은 경우 기존 방식으로 저장합니다.
  • 서버의 Docker 컨테이너를 docker compose를 이용해 재시작하고 재시작 후 상태를 확인합니다.
  • 필요 시 현재 로컬 프로젝트 디렉토리명과 일치하는 서버 경로를 자동 탐색합니다.

Quick Start

Run /retoken <ssh-name> [slot] [project-path] to synchronize Claude OAuth tokens from Mac Keychain to the remote server and restart the Docker container.

Frequently Asked Questions about retoken

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

FAQPage Schema
How do I sync Claude OAuth tokens from Mac Keychain to a remote server?

Sync Claude OAuth tokens to a remote server by reading credentials from Mac Keychain, mapping them to slot-based accounts, and applying them via SSH to the target project directory.

Can I sync multiple Claude accounts using different slots to my server?

Yes, multi-account slots are supported. You can specify slot 0, 1, or 2 to map specific credentials, and if a slot is not provided, the system saves the token using the default legacy method.

Does this tool restart Docker containers after updating the OAuth token?

Yes, after syncing the token, it restarts the athena-core Docker container using docker-compose and verifies the LLM status to ensure the updated credentials are active.

How do I auto-detect the project path on the remote server during token sync?

When the project path is not explicitly provided, the token sync process automatically searches the remote server for a directory matching your current local project directory name.

What do I need to run the Claude token synchronization process?

You need an SSH connection configured for the remote server, Mac Keychain storing your Claude OAuth tokens, and docker-compose managing the athena-core container on the target server.

Why does my Docker container need restarting after syncing Claude tokens?

Restarting the Docker container via docker-compose ensures the athena-core service reloads the newly synced OAuth tokens and allows you to verify the LLM status is functioning correctly.