alai-studios/Codex Sync
Sync files from a repository directory to a Spark Codex with intelligent diffing
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Feb 11, 2026
- License
- MIT
Pinned Snippet
uses: alai-studios/codex-sync@c751a8bc22ca151e58b445c4b0f793f891a629c1 # v1.3tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| spark_api_key | Spark API Key (Authress service client access key with contents:write permissions) | yes | — |
| codex_id | Codex ID to sync files to | yes | — |
| directory | Directory path (relative to repo root) containing files to sync | yes | — |
| api_base_url | Spark API base URL | no | https://api.spark.my.alaispark.app |
| file_extensions | Comma-separated list of file extensions to sync (default: pdf,txt,md,mdx,png,jpg,jpeg,webp,gif,mp3,mp4) | no | pdf,txt,md,mdx,png,jpg,jpeg,webp,gif,mp3,mp4 |
| dry_run | If true, only show diff without making changes | no | false |
| delete_removed | If true, delete files from Codex that no longer exist locally | no | true |
| debug | If true, enable debug logging for troubleshooting | no | false |
Outputs
| name | description |
|---|---|
| files_added | Number of files added to Codex |
| files_updated | Number of files updated in Codex |
| files_deleted | Number of files deleted from Codex |
| files_unchanged | Number of files unchanged |