README file from
GithubAI Switch
Sync AI coding tool configuration snapshots into your vault. This plugin starts as a simple config snapshot syncer and will grow into a helper for programming beginners to quickly switch and configure AI models.
Features
- Copies local AI tool configs into Markdown snapshots such as
Config Manager/zhang_aifende_macbook-air/codex/config.toml.md. - Automatically groups snapshots by machine and tool folder.
- Syncs when the plugin loads, when settings change, or when the ribbon button is clicked.
- Provides a small sidebar for syncing snapshots and applying a note snapshot back to local config.
- Supports custom config sources: add any config file or folder by name and path, alongside the built-in Codex / Claude / OpenCode presets.
- Read-only for system config directories; it only reads local files and writes snapshots into the vault.
Usage
- Enable the plugin.
- Keep
Codex,ClaudeandOpenCodechecked if you want to sync them. - Change a tool path only when your config is stored somewhere else.
- Click the ribbon button to open the
AI Switchsidebar. - Use
Sync to noteto refresh snapshots, orApply to localto write a snapshot back to the local config file. - Open files directly in Obsidian's file explorer:
Config Manager/
└── zhang_aifende_macbook-air/
├── codex/
│ └── config.toml.md
├── claude/
│ └── settings.json.md
└── opencode/
└── opencode.json.md
Custom config sources:
In Settings → AI Switch → Custom config sources, click Add custom source and enter a name and path (supports ~, files or folders, .toml / .json / .yaml / .yml). Each source syncs the same way as the built-in tools and can be toggled or removed.
Default tool paths:
~/.codex/config.toml
~/.claude/settings.json
~/.config/opencode
Folder sources import .toml, .json, .yaml and .yml files recursively. Missing paths are skipped automatically.
When applying a snapshot to local config, AI Switch asks for confirmation and creates a timestamped backup next to the original file before overwriting it.
Roadmap
- Show model/provider presets for common AI coding tools.
- Help beginners switch model configs safely.
- Add controlled config apply/write-back flows after snapshot viewing is stable.
Settings
Config root folder: Vault-relative folder for snapshots. Default:Config Manager.Codex: Sync~/.codex/config.tomlby default.Claude: Sync~/.claude/settings.jsonby default.OpenCode: Sync~/.config/opencodeby default.
Development
npm install
npm run build
License
MIT