# aisync

> aisync keeps a Claude Code setup (settings.json, CLAUDE.md, skills, agents, commands, user MCP servers) as profiles in the user's own private GitHub repo and applies it on any machine with one pull. MCP tokens are encrypted (AES-256-GCM, passphrase) or kept in HashiCorp Vault; neither the repo nor ~/.claude.json ever holds a token in plain text, because servers are wrapped in `aisync exec` or given a `headersHelper`. Go CLI, no server, login via the GitHub CLI. Unofficial; not affiliated with Anthropic.

Status: private beta (aisync 0.1). The source and install script are not public yet.

Key facts:
- One profile maps to one Claude Code config dir (CLAUDE_CONFIG_DIR): default = ~/.claude, other = ~/.claude-<name>; profiles can extend one base profile.
- Not synced: Claude login, projects/, history, caches, skills/synced/, skills/.trash/, plugin binaries.
- Secret refs: {{secret:NAME}} (encrypted store) and {{vault:MOUNT/PATH#FIELD}} (Vault KV v2, token auth only); {{home}} for the home directory.
- Start with `aisync scan` (finds hardcoded secrets, uploads nothing), then `aisync login`, `aisync capture default`, and `aisync pull default` on another machine.

## Docs (English)

- [Get started](https://aisync.creco.dev/en/docs/start/index.md): From installing to pulling your setup on a new machine, the steps you do once.
- [How it works](https://aisync.creco.dev/en/docs/how-it-works/index.md): What is stored in the repo, and what gets written to this machine on a pull.
- [Secrets](https://aisync.creco.dev/en/docs/secrets/index.md): How tokens stay out of plain text, both in the repo and in your config files.
- [Profiles and multiple accounts](https://aisync.creco.dev/en/docs/profiles/index.md): How to split and share your setup when you run Claude Code with several accounts, such as personal and work.
- [Syncing and conflicts](https://aisync.creco.dev/en/docs/sync/index.md): What aisync keeps and what it asks about when more than one machine made changes.
- [Using Vault](https://aisync.creco.dev/en/docs/vault/index.md): If you already run HashiCorp Vault, keep tokens there and only references in your setup.
- [Admin UI](https://aisync.creco.dev/en/docs/ui/index.md): See and edit this machine's Claude Code setup in the browser.
- [Security model](https://aisync.creco.dev/en/docs/security/index.md): What aisync protects, and what it doesn't.
- [Command reference](https://aisync.creco.dev/en/docs/commands/index.md): Every command and option.
- [Troubleshooting](https://aisync.creco.dev/en/docs/troubleshooting/index.md): Common errors and how to fix them.

## Docs (Korean, the site's default language)

- [시작하기](https://aisync.creco.dev/docs/start/index.md): 설치부터 새 컴퓨터에서 설정을 받기까지, 처음 한 번 하는 과정입니다.
- [동작 방식](https://aisync.creco.dev/docs/how-it-works/index.md): 리포에 무엇이 저장되고, 받을 때 이 컴퓨터에 무엇이 쓰이는지 설명합니다.
- [시크릿](https://aisync.creco.dev/docs/secrets/index.md): 토큰이 리포에도, 설정 파일에도 평문으로 남지 않는 방법입니다.
- [프로필과 여러 계정](https://aisync.creco.dev/docs/profiles/index.md): 개인 계정과 회사 계정처럼 Claude Code를 여러 계정으로 함께 쓸 때 설정을 나누고 공유하는 방법입니다.
- [동기화와 충돌](https://aisync.creco.dev/docs/sync/index.md): 여러 컴퓨터에서 고쳤을 때 aisync가 무엇을 지키고 무엇을 묻는지 설명합니다.
- [Vault 연동](https://aisync.creco.dev/docs/vault/index.md): 이미 HashiCorp Vault를 쓰고 있다면 토큰을 Vault에 두고 참조만 남길 수 있습니다.
- [어드민 UI](https://aisync.creco.dev/docs/ui/index.md): 이 컴퓨터의 Claude Code 설정을 브라우저에서 보고 고칩니다.
- [보안 모델](https://aisync.creco.dev/docs/security/index.md): aisync가 무엇을 지켜 주고, 무엇은 지켜 주지 못하는지 정리했습니다.
- [명령 레퍼런스](https://aisync.creco.dev/docs/commands/index.md): 모든 명령과 옵션입니다.
- [문제 해결](https://aisync.creco.dev/docs/troubleshooting/index.md): 자주 만나는 오류와 해결 방법입니다.

## Optional

- [Full docs in one file (English)](https://aisync.creco.dev/llms-full.txt)
- [Full docs in one file (Korean)](https://aisync.creco.dev/ko/llms-full.txt)