@chatium/skill
v0.1.1
Published
Chatium sync skill for AI coding agents (Claude Code, Codex CLI) — installs a skill that syncs your local folder with a Chatium account
Readme
@chatium/skill
Installs the Chatium Sync skill for AI coding agents — Claude Code and Codex CLI. The skill syncs your local folder with a Chatium account: pull, upload, status, static files, and more.
Install
npx @chatium/skillOr globally:
npm install -g @chatium/skillThe installer downloads the skill files from github.com/chatium/skill and installs them for every agent found on your machine:
- Claude Code →
~/.claude/skills/chatium-sync/ - Codex CLI →
~/.codex/skills/chatium-sync/
After install, restart your agent — the chatium-sync skill activates automatically (in Claude Code it is also available as the /chatium-sync slash command).
Quick start
# 1. cd into your Chatium project folder
cd ~/projects/my-chatium-app
# 2. Ask the agent to connect the folder to your Chatium account,
# or in Claude Code:
/chatium-sync init <account> <token>
/chatium-sync pull --forceGet your API token at https://<your-account>/s/login/external-tool/token.
The server is always the source of truth: the local folder is a working cache for searching and editing. The skill refreshes it with pull --force and uploads each changed file back with upload right after editing.
What it includes
SKILL.md— skill definition (SKILL.md standard, works in Claude Code and Codex CLI)chatium-sync.sh— sync engine (init, pull, push, sync, status, upload, upload-static, typings, delete, rename)- Documentation modules:
coding.md,heap.md,heap-filter.md,auth.md,routing.md,storage.md
Commands
| Command | Description |
| --- | --- |
| init <account> <token> | Configure your Chatium account |
| status | Show sync status and local changes |
| pull [--force] | Download files from server |
| push [--force] | Upload changed files to server |
| sync [--force] | Typings + pull + push (full sync) |
| typings | Download TypeScript typings |
| upload <path> | Upload a single code file |
| upload-static <path> | Upload binary/image, get hash + URLs |
| delete <path> | Delete a file on the server |
| rename <old> <new> | Rename a file on the server |
Requirements
- Node.js 18+ (for the installer)
bash,curl,jq,shasumfor the skill script (preinstalled on macOS/Linux; on Windows use Git Bash or WSL)
Custom branch
Install from a different branch:
CHATIUM_SKILL_BRANCH=dev npx @chatium/skillLicense
MIT
