{"id":44320303,"url":"https://github.com/intelligentcode-ai/intelligent-code-agents","last_synced_at":"2026-02-14T08:16:19.294Z","repository":{"id":337221102,"uuid":"1152736204","full_name":"intelligentcode-ai/intelligent-code-agents","owner":"intelligentcode-ai","description":"Intelligent Code Agents (ICA): portable skills, workflows, and installers for multiple AI agents and IDEs.","archived":false,"fork":false,"pushed_at":"2026-02-08T17:57:55.000Z","size":382,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"dev","last_synced_at":"2026-02-08T18:06:25.789Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/intelligentcode-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-08T10:56:52.000Z","updated_at":"2026-02-08T15:48:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/intelligentcode-ai/intelligent-code-agents","commit_stats":null,"previous_names":["intelligentcode-ai/intelligent-code-agents"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/intelligentcode-ai/intelligent-code-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelligentcode-ai%2Fintelligent-code-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelligentcode-ai%2Fintelligent-code-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelligentcode-ai%2Fintelligent-code-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelligentcode-ai%2Fintelligent-code-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/intelligentcode-ai","download_url":"https://codeload.github.com/intelligentcode-ai/intelligent-code-agents/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intelligentcode-ai%2Fintelligent-code-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29327998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T03:52:29.695Z","status":"ssl_error","status_checked_at":"2026-02-11T03:52:23.094Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-11T06:10:23.396Z","updated_at":"2026-02-14T08:16:19.289Z","avatar_url":"https://github.com/intelligentcode-ai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Intelligent Code Agents (ICA)\n\nICA is the fastest path from \"nothing installed\" to a working, managed agent stack.\n\nUse one CLI and one local dashboard to install, sync, audit, and update skills across runtimes without hand-wired setup.\n\nWhat ICA gives you:\n- one command surface for install/uninstall/sync/audit\n- source-aware skill management with explicit pinning (`\u003csource\u003e/\u003cskill\u003e`)\n- CLI + local dashboard workflows\n- verified bootstrap installers and reproducible releases\n\n## Skills Repository + Contribution\n\nOfficial skills live in the standalone Skills repository:\n- [intelligentcode-ai/skills](https://github.com/intelligentcode-ai/skills)\n\nWant to add a custom skill?\n- Open a PR in the Skills repo: [Create Pull Request](https://github.com/intelligentcode-ai/skills/pulls)\n- Follow contribution requirements in: [How to Contribute](https://github.com/intelligentcode-ai/skills#how-to-contribute)\n\n## Agent Bootstrap Prompt (IDE/Local Agent)\n\nUse this when you want your local agent to do setup for you end-to-end.\n\nPaste this into your coding agent:\n\n```text\nBootstrap ICA for this local environment.\n\nYour task:\n1) Download and install this skill file into your own native skill storage (using your runtime's normal skill conventions):\n   https://raw.githubusercontent.com/intelligentcode-ai/skills/master/skills/ica-bootstrap/SKILL.md\n2) Immediately execute the installed `ica-bootstrap` skill.\n3) Let `ica-bootstrap` complete end-to-end setup, including:\n   - ICA CLI installation\n   - skills source registration/refresh\n   - installation of `ica-cli`\n   - verification (`ica doctor`, `ica list`)\n\nBehavior requirements:\n- Do the work directly on this machine.\n- Do not ask me where skill folders are.\n- Do not ask me to confirm routine steps.\n- Ask only if credentials, permissions, or security policy block execution.\n- If a command fails, diagnose and retry with the safest fallback automatically.\n\nFinal output:\n- What you installed\n- What you executed\n- Current ICA health/status\n- Exact blocker only if setup is still not complete\n```\n\nCanonical prompt source:\n- [skills/ica-bootstrap/assets/INITIAL_PROMPT.md](https://github.com/intelligentcode-ai/skills/blob/master/skills/ica-bootstrap/assets/INITIAL_PROMPT.md)\n\n## Install First (Verified Bootstrap)\n\nIf you're setting up manually, this is the safest and fastest starting point.\n\nBootstrap downloads the latest source artifact (`ica-\u003ctag\u003e-source.tar.gz`), verifies it against `SHA256SUMS.txt`, and installs `ica`.\n\nmacOS/Linux:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/intelligentcode-ai/intelligent-code-agents/main/scripts/bootstrap/install.sh | bash\n```\n\nWindows PowerShell:\n\n```powershell\niwr https://raw.githubusercontent.com/intelligentcode-ai/intelligent-code-agents/main/scripts/bootstrap/install.ps1 -UseBasicParsing | iex\n```\n\nThen run:\n\n```bash\nica install\nica launch --open=true\n```\n\n## Multi-Source Skills (Clear + Explicit)\n\nICA supports multiple skill repositories side-by-side.\n\n- Add official and custom repos (HTTPS/SSH)\n- Keep each source cached locally under `~/.ica/\u003csource-id\u003e/skills`\n- Select skills explicitly as `\u003csource\u003e/\u003cskill\u003e` to avoid ambiguity\n- Remove a source without deleting already installed skills (they are marked orphaned)\n- Use the same model in CLI and dashboard\n\n## Dashboard Preview\n\n### Animated preview (appearance + layout)\n![ICA Dashboard Animated Preview](docs/assets/dashboard/dashboard-preview.gif)\n\n### 1) Start with current state\n![ICA Dashboard Current State](docs/assets/dashboard/dashboard-step-01-current-state.png)\nInitial installed/selected overview before changing targets, scope, or skills.\n\n### 2) Select skills and scope\n![ICA Dashboard Skill Selection](docs/assets/dashboard/dashboard-step-02-selection.png)\n`Project` scope with explicit target + skill selection (`reviewer`, `developer`, `process`).\n\n### 3) Search/filter skills\n![ICA Dashboard Search](docs/assets/dashboard/dashboard-step-03-search.png)\nLive filtering by keyword (`review`) while preserving selected targets/scope.\n\n### 4) Install selected skills\n![ICA Dashboard Installation](docs/assets/dashboard/dashboard-step-04-installation.png)\nPost-install evidence with expanded `Installed State` and `Operation Report`.\n\n### 5) Manage installed skills (uninstall/sync/report)\n![ICA Dashboard Management](docs/assets/dashboard/dashboard-step-05-management.png)\nManagement action example (`Uninstall selected`) with updated state/report.\n\n### 6) Manage hooks\n![ICA Dashboard Hooks](docs/assets/dashboard/dashboard-step-06-hooks.png)\nDedicated hooks catalog/actions with source-aware hook install state.\n\n## Build From Source\n\n```bash\nnpm ci\nnpm run build\n```\n\n## CLI Usage (`ica`)\n\n```bash\n# Install into user scope for Codex + Claude\nnode dist/src/installer-cli/index.js install --yes \\\n  --targets=codex,claude \\\n  --scope=user \\\n  --mode=symlink\n```\n\n```bash\n# Project scope, selected skills only\nnode dist/src/installer-cli/index.js install --yes \\\n  --targets=codex \\\n  --scope=project \\\n  --project-path=/path/to/project \\\n  --mode=symlink \\\n  --skills=developer,architect,reviewer\n```\n\nCommands:\n- `ica install`\n- `ica uninstall`\n- `ica sync`\n- `ica list`\n- `ica doctor`\n- `ica catalog`\n- `ica launch`\n- `ica sources list`\n- `ica sources add --repo-url=...` (or `--repo-path=...`; defaults to current directory when omitted)\n- `ica sources remove --id=...`\n- `ica sources auth --id=... --token=...`\n- `ica sources refresh [--id=...]`\n- `ica sources update --id=... --name=... --repo-url=...`\n- `ica container mount-project --project-path=/path --confirm`\n\nSource-qualified example:\n\n```bash\nnode dist/src/installer-cli/index.js install --yes \\\n  --targets=codex \\\n  --scope=user \\\n  --skills=official-skills/reviewer,official-skills/developer\n```\n\nLegacy `--skills=\u003cname\u003e` is still accepted and resolves against the official source.\n\nCustom repositories are persisted in `~/.ica/sources.json` (or `$ICA_STATE_HOME/sources.json` when set).\n\nDownloaded source skills are materialized under `~/.ica/\u003csource-id\u003e/skills` (or `$ICA_STATE_HOME/\u003csource-id\u003e/skills`).\nWhen install mode is `symlink`, ICA links installed skills from that local skills snapshot.\n\n## Dashboard\n\nStart locally (binds to `127.0.0.1`):\n\n```bash\nnpm ci\nnpm run build\nnpm run start:dashboard\n```\n\nOpen: `http://127.0.0.1:4173`\n\n### GHCR Container\n\nDashboard highlights:\n\n- Install, uninstall, and sync skills across multiple targets\n- Add/remove/auth/refresh skill sources (HTTPS + SSH)\n- Target discovery plus user/project scope management\n- Native project directory picker (host helper) plus container mount orchestration endpoint\n- Skill catalog filtering with bulk selection controls\n- Installed-state and operation-report inspection in the UI\n\nContainer image can be built from `src/installer-dashboard/Dockerfile` and published to GHCR via `.github/workflows/dashboard-ghcr.yml`.\n\nBuild from source:\n\n```bash\ndocker build -f src/installer-dashboard/Dockerfile -t ica-dashboard:local .\n```\n\nRun:\n\n```bash\ndocker run --rm -p 4173:4173 ica-dashboard:local\n```\n\n## Supported Targets\n\n- `claude`\n- `codex`\n- `cursor`\n- `gemini`\n- `antigravity`\n\n## Install Modes\n\n- `symlink` (default)\n- `copy`\n\nIf symlink creation fails, ICA falls back to `copy` and records the effective mode.\n\n## Scope Modes\n\n- `user` scope: installs into tool home (`~/.claude`, `~/.codex`, ...)\n- `project` scope: installs into `\u003cproject\u003e/\u003cagent-home-dir\u003e`\n\nCLI default for project scope: when `--scope=project` is used without `--project-path`, ICA uses the current working directory.\n\n## Managed State\n\nICA tracks managed installs in:\n\n- `\u003cagent-home\u003e/.ica/install-state.json`\n\nThis enables safe uninstall/sync of managed assets without deleting unmanaged user content.\n\n## Release + Supply Chain\n\nTag releases from `main` (`vX.Y.Z`). The `release-sign` workflow:\n- builds deterministic artifacts\n- verifies reproducibility\n- signs via keyless Sigstore flow\n- attaches signatures/certs/checksums to GitHub release assets\n\n## Documentation\n\n- [Installation Guide](docs/installation-guide.md)\n- [Configuration Guide](docs/configuration-guide.md)\n- [Workflow Guide](docs/workflow-guide.md)\n- [Release Signing](docs/release-signing.md)\n\n## Legacy Deployment Paths Removed\n\nLegacy deployment entrypoints were removed:\n- `Makefile` deployment flow\n- Ansible deployment flow\n- old root `install.ps1` deployment wrapper\n\nUse bootstrap, `ica` CLI, or dashboard going forward.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintelligentcode-ai%2Fintelligent-code-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintelligentcode-ai%2Fintelligent-code-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintelligentcode-ai%2Fintelligent-code-agents/lists"}