# Start

> Initialize Any Sync config and run first pull — guided setup wizard

- Skill: `imink/start` (Agent Skill)
- Install (CLI): `npx skillmds@latest add imink/start`
- Raw SKILL.md: https://api.skillmd.com/api/skills/imink/start/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: imink (https://skillmd.com/u/imink)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/imink/start

---


# Any Sync Setup Wizard

Guide the user through setting up Any Sync for cross-device sync.

## Steps

### 1. Check Authentication

Run the auth check:
```bash
npx @any-sync/cli auth
```

If it fails (exit code 1), help the user set up authentication:
- Option A: Set `GITHUB_TOKEN` environment variable
- Option B: Run `gh auth login` to authenticate with GitHub CLI

Do not proceed until auth succeeds.

### 2. Get Sync Repo

Ask the user for their sync repo in `owner/repo` format. This is the GitHub repository where their Claude files will be stored.

If they don't have one yet, suggest they create a new private repo on GitHub first.

### 3. Create Config

Ask the user which items to sync (default: all three):
- Skills (`~/.claude/skills`)
- Memory (`~/.claude/memory`)
- Settings (`~/.claude/settings.json`)

Then run the init command with the Claude preset:
```bash
npx @any-sync/cli init "$HOME/.any-sync.json" "<owner/repo>" "<branch>" --preset claude
```

Use `main` as the default branch unless the user specifies otherwise.

### 4. First Pull

Run the first pull to download existing files:
```bash
npx @any-sync/cli pull "$HOME/.any-sync.json" ".any-sync.lock"
```

### 5. Show Summary

Parse the JSON output and display what was synced in a readable format:
- Number of files pulled per mapping
- Any conflicts found
- Config file location

