{"id":48738813,"url":"https://github.com/mattslight/oyster","last_synced_at":"2026-05-09T18:03:26.930Z","repository":{"id":350680939,"uuid":"1181793345","full_name":"mattslight/oyster","owner":"mattslight","description":"A modern OS for knowledge work powered by LLM — connect your projects, control everything from a prompt / MCP","archived":false,"fork":false,"pushed_at":"2026-04-18T18:17:15.000Z","size":10812,"stargazers_count":1,"open_issues_count":59,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T19:33:14.677Z","etag":null,"topics":["ai","developer-tools","knowledge-management","mcp","operating-system","os","workspace"],"latest_commit_sha":null,"homepage":"http://oyster.to/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattslight.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":null,"dco":null,"cla":null}},"created_at":"2026-03-14T16:25:19.000Z","updated_at":"2026-04-18T18:14:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mattslight/oyster","commit_stats":null,"previous_names":["mattslight/oyster"],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/mattslight/oyster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattslight%2Foyster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattslight%2Foyster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattslight%2Foyster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattslight%2Foyster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattslight","download_url":"https://codeload.github.com/mattslight/oyster/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattslight%2Foyster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32022561,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","developer-tools","knowledge-management","mcp","operating-system","os","workspace"],"created_at":"2026-04-12T06:08:51.066Z","updated_at":"2026-05-09T18:03:26.912Z","avatar_url":"https://github.com/mattslight.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"docs/hero-banner.png\" alt=\"Oyster — From prompt to workspace\" /\u003e\u003c/p\u003e\n\n[![Release](https://img.shields.io/github/v/release/mattslight/oyster?color=7c6bff)](https://github.com/mattslight/oyster/releases)\n[![npm](https://img.shields.io/npm/v/oyster-os?color=7c6bff)](https://www.npmjs.com/package/oyster-os)\n[![Downloads](https://img.shields.io/npm/dm/oyster-os?color=7c6bff)](https://www.npmjs.com/package/oyster-os)\n[![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Linux%20%7C%20Windows-7c6bff)]()\n[![License](https://img.shields.io/badge/License-AGPL--3.0-7c6bff)](LICENSE)\n\n---\n\n**🦪 Every agent, one shared brain.** Oyster watches your AI sessions, captures the files they touched and the memories they wrote, and brings them all into one workspace — visible, searchable, persistent across every machine. Built on MCP.\n\n```bash\n# 1. Install\nnpm install -g oyster-os\n\n# 2. Start\noyster\n\n# 3. Open your browser to http://localhost:4444\n```\n\n## Why Oyster\n\nYour AI sessions, files, and memories live in tool-shaped silos. Oyster puts every agent's work on one shared surface, organised by space.\n\n- **See every agent at work** — Oyster watches Claude Code automatically. Live transcripts, status (active / awaiting / disconnected / done), and the files each session touched, all on Home.\n- **Memory that survives sessions** — `remember` notes are first-class. Every agent's `recall` reads from the same store, so context follows you across tools and machines.\n- **Drop in any project** — point Oyster at a folder and it scans for documents, apps, and diagrams, then attributes future sessions back to the right project.\n- **Bring any agent** — Oyster is an MCP server. Claude Code, Cursor, VS Code, Windsurf, or your own — one standard, every agent.\n\n## Quick Start\n\n```bash\nnpm install -g oyster-os\noyster\n```\n\nThat's it. On first run, Oyster connects you to an AI provider (opens your browser to sign in). Then your workspace opens at **http://localhost:4444**.\n\nOr try without installing:\n\n```bash\nnpx oyster-os\n```\n\n## Connect Your AI\n\nOyster is an MCP server. Any MCP-compatible tool can connect and control your workspace.\n\n**Claude Code:**\n\n```bash\nclaude mcp add --scope user --transport http oyster http://localhost:4444/mcp/\n```\n\n**Cursor / VS Code / other MCP clients** — add to your MCP config:\n\n```json\n{\n  \"oyster\": {\n    \"type\": \"http\",\n    \"url\": \"http://localhost:4444/mcp/\"\n  }\n}\n```\n\nOnce connected, your AI can list spaces, open artefacts, create documents, onboard projects, and manage the surface directly.\n\n## Onboard a Project\n\nFrom the Oyster chat bar:\n\n```\nonboard my project at ~/Dev/my-project\n```\n\nOyster scans the folder for documents, apps, and diagrams and adds them to the surface automatically.\n\n## Commands\n\n| Command | What it does |\n|---|---|\n| `/s \u003cspace\u003e` | Switch to a space — `/s blunderfixer` opens that space |\n| `/o \u003cquery\u003e` | Open an artefact by name — `/o pricing deck` finds and opens it |\n| `#\u003cspace\u003e` | Quick space switch — `#home` goes home, `#bf` matches blunderfixer |\n| `#\u003cnumber\u003e` | Jump to a numbered space — `#1` switches to first space |\n| `#.` | Go to the home screen |\n| normal chat | Ask Oyster anything — navigate, organise, or create work |\n\n## Architecture\n\n```\nBrowser → http://localhost:4444\n              |\n        Oyster Server\n         - SQLite (artefacts, spaces)\n         - MCP server (/mcp/)\n         - SSE push (instant UI updates)\n         - Static web UI\n         - Chat proxy → OpenCode → LLM\n```\n\n## Status\n\nEarly v1. Local-first. Single-user. Built for fast iteration.\n\n- **Now (`0.5.x`)** — Sessions feed (Claude Code), Memories on Home, Project tiles per space, repo onboarding, 19 MCP tools, slash commands.\n- **Next (`0.6.x`)** — Bundles. Multi-file static artefacts; agents push artefacts via MCP.\n- **Then (`0.7.x`)** — Oyster Pro. Auth, cross-device sync, end-to-end encrypted storage, shareable links. ([pricing](https://oyster.to/pricing))\n- **Then (`0.8.x`)** — Multi-agent ingestion. Cursor, Codex, OpenCode session feeds — every agent feeds the same workspace.\n\nSee every shipped change in the [changelog](https://oyster.to/changelog).\n\n## Contributing\n\nOyster is early, but focused contributions are welcome.\n\n1. Open an issue first\n2. Keep the scope tight\n3. Send a focused PR with a clear before and after\n\n### Development\n\n```bash\ngit clone https://github.com/mattslight/oyster.git\ncd oyster\ncd web \u0026\u0026 npm install \u0026\u0026 cd ../server \u0026\u0026 npm install \u0026\u0026 cd ..\nnpm run dev\n# → dev server at http://localhost:7337 (proxies to server at 3333)\n```\n\n## Licence\n\n[AGPL-3.0](LICENSE)\n\nCopyright (c) 2026 Matthew Slight\n\nYou can use, modify, and distribute this software freely. If you run a modified version as a network service, you must make your source code available under the same licence.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattslight%2Foyster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattslight%2Foyster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattslight%2Foyster/lists"}