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.