{"id":47720324,"url":"https://github.com/a-tokyo/aiworkspace","last_synced_at":"2026-04-06T00:01:05.377Z","repository":{"id":348151919,"uuid":"1196520623","full_name":"a-tokyo/aiworkspace","owner":"a-tokyo","description":"🧑‍💻 Set up and manage AI agent skills and configs for Cursor, Claude Code, Codex and more across multi-repo workspaces.","archived":false,"fork":false,"pushed_at":"2026-04-02T21:17:18.000Z","size":89,"stargazers_count":11,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T23:18:38.254Z","etag":null,"topics":["agentic-engineering","agents","ai","ai-sdlc","antigravity","claude","codex","context-ai","copilot","cursor","openclaw","plans","shared-workspace","skills","workspace"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a-tokyo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-03-30T19:26:29.000Z","updated_at":"2026-04-04T08:25:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"53dfbf66-3070-4ef6-baf4-eaf8c930c82b","html_url":"https://github.com/a-tokyo/aiworkspace","commit_stats":null,"previous_names":["a-tokyo/aiworkspace"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/a-tokyo/aiworkspace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tokyo%2Faiworkspace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tokyo%2Faiworkspace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tokyo%2Faiworkspace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tokyo%2Faiworkspace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a-tokyo","download_url":"https://codeload.github.com/a-tokyo/aiworkspace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tokyo%2Faiworkspace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31454200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["agentic-engineering","agents","ai","ai-sdlc","antigravity","claude","codex","context-ai","copilot","cursor","openclaw","plans","shared-workspace","skills","workspace"],"created_at":"2026-04-02T19:21:47.401Z","updated_at":"2026-04-06T00:01:05.351Z","avatar_url":"https://github.com/a-tokyo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Workspace\n\nManage shared AI agent skills, configs, and automation across multi-repo workspaces. Works with Cursor, Claude Code, Codex, Amp, and 40+ AI coding tools.\n\n\u003ca href=\"https://npmjs.com/package/aiworkspace\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/aiworkspace.svg\" alt=\"npm version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/npm/dt/aiworkspace.svg\" alt=\"npm downloads\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://twitter.com/intent/follow?screen_name=ahmedtokyo\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/ahmedtokyo.svg?label=Follow%20@ahmedtokyo\" alt=\"Follow @ahmedtokyo\" /\u003e\u003c/a\u003e\n\n\u003cbr /\u003e\n\n**The problem**: AI agents only see the repo they run in. An agent working in a frontend repo has no visibility into the backend, API contracts, or shared conventions -- so it assumes and hallucinates. On top of that, each developer configures AI tools differently, so skills, instructions, and rules drift between projects and team members.\n\n**The solution**: A single `workspace/` repo that acts as the canonical source. Running `npm install` mirrors configs to the parent root, symlinks skills for every AI tool, and installs git hooks to keep everything in sync.\n\n## Quick Start\n\n**Create a new workspace** (one-time, by whoever sets it up):\n\n```bash\nmkdir ~/dev/\u003cyour-org\u003e \u0026\u0026 cd ~/dev/\u003cyour-org\u003e\nnpx aiworkspace init\ncd workspace\ngit remote add origin \u003cyour-repo-url\u003e\ngit push -u origin main\n```\n\n**Join an existing workspace** (every other team member):\n\n```bash\ncd ~/dev/\u003cyour-org\u003e\ngit clone \u003cyour-teams-workspace-repo\u003e workspace\ncd workspace \u0026\u0026 npm install\n```\n\n`npm install` restores skills from the lockfile, mirrors configs to the parent root, creates skill symlinks, and installs git hooks. See [setup.md](setup.md) for the full guide.\n\n## How It Works\n\n```\n~/dev/\u003cyour-org\u003e/                       \u003c- open this in Cursor / your editor\n├── workspace/                          \u003c- this repo\n│   ├── root-config/                    \u003c- canonical source for root-level AI configs\n│   │   ├── AGENTS.md                   \u003c- standing instructions for all AI tools\n│   │   ├── .agents/skills/             \u003c- workspace-wide skills\n│   │   └── skills-lock.json            \u003c- lockfile for workspace-wide skills\n│   ├── .agents/skills/                 \u003c- workspace project-specific skills\n│   ├── scripts/                        \u003c- automation (setup, hooks, skill wrappers)\n│   └── package.json\n├── \u003cproject-a\u003e/                        \u003c- your app / service / library\n├── \u003cproject-b\u003e/\n└── ...\n```\n\nThe setup script walks `root-config/` generically. Add new config types (Cursor rules, Claude settings, Codex config) and they sync automatically with no script changes.\n\n## Knowledge Hierarchy\n\nEverything follows **nearest-wins**: the closer a file is to the code being changed, the higher its priority.\n\n| What | Workspace-wide | Per-project |\n|------|---------------|-------------|\n| Instructions | `root-config/AGENTS.md` synced to root | `\u003cproject\u003e/AGENTS.md` |\n| Skills | `root-config/.agents/skills/` symlinked everywhere | `\u003cproject\u003e/.agents/skills/` |\n| Cursor rules | `root-config/.cursor/rules/` symlinked | `\u003cproject\u003e/.cursor/rules/` |\n| Docs | `docs/` repo (sibling) | `\u003cproject\u003e/docs/` |\n\n## Skills\n\n```bash\nnpm run skills:add -- \u003csource\u003e [--project \u003crepo\u003e]      # add from registry\nnpm run skills:add -- owner/repo --skill \u003cname\u003e         # pick from multi-skill repo\nnpm run skills:remove -- [\u003cskill\u003e] [--project \u003crepo\u003e]   # remove\nnpm run skills:create -- --name my-skill                # create manually\nnpm run skills:list                                      # list installed\nnpm run skills:find                                      # search skill registry\nnpm run skills:update                                    # update all\nnpm run skills:check                                     # check for available updates\nnpm run skills:setup                                     # re-sync configs and symlinks\n```\n\nWithout `--project`, skills install to `root-config/.agents/skills/` (workspace-wide). With `--project \u003crepo\u003e`, they go to `\u003crepo\u003e/.agents/skills/` (project-only).\n\nSkills are tracked in `skills-lock.json` (source + hash). On `npm install`, they are restored from the lockfile automatically.\n\n## Upgrading\n\n```bash\nnpm run upgrade\n```\n\nIf `aiworkspace` is in `devDependencies`, this updates that package from npm and copies its `scripts/` into yours (your team's `version` field stays independent). Otherwise the workspace falls back to git: `upstream` remote + `upstream/main` for `scripts/`. `npx aiworkspace init` sets `upstream` automatically. See [setup.md](setup.md) for details.\n\n## Requirements\n\n- Node.js \u003e= 18\n- Git\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-tokyo%2Faiworkspace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa-tokyo%2Faiworkspace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-tokyo%2Faiworkspace/lists"}