{"id":50953949,"url":"https://github.com/afar1/fieldtheory","last_synced_at":"2026-06-18T04:32:32.384Z","repository":{"id":364931931,"uuid":"1262299325","full_name":"afar1/fieldtheory","owner":"afar1","description":"Mac app to create context for agents: writing, reading, voice, terminal, bookmarks, and clipboard.","archived":false,"fork":false,"pushed_at":"2026-06-15T05:24:03.000Z","size":22515,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-15T07:21:28.304Z","etag":null,"topics":["agent-tools","electron","local-first","macos","markdown"],"latest_commit_sha":null,"homepage":"https://fieldtheory.dev","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/afar1.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.md","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T20:33:01.000Z","updated_at":"2026-06-15T05:33:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/afar1/fieldtheory","commit_stats":null,"previous_names":["afar1/fieldtheory"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/afar1/fieldtheory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afar1%2Ffieldtheory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afar1%2Ffieldtheory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afar1%2Ffieldtheory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afar1%2Ffieldtheory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/afar1","download_url":"https://codeload.github.com/afar1/fieldtheory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afar1%2Ffieldtheory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34476727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"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":["agent-tools","electron","local-first","macos","markdown"],"created_at":"2026-06-18T04:32:31.953Z","updated_at":"2026-06-18T04:32:32.373Z","avatar_url":"https://github.com/afar1.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Field Theory\n\nField Theory is a local-first macOS application for human and agentic reading and writing. It is designed to make context management fast, local, and portable between model providers, with local voice transcription, clipboard management, portable Markdown commands and skills, and extraction, storage, and local retrieval of X bookmarks.\n\nThe Mac app DMG can be downloaded and used for free at [fieldtheory.dev](https://fieldtheory.dev). All accounts are free.\n\n## Project Status\n\nThis is the Field Theory app source repository, seeded from the cleaned Field Theory development history and developed by Andrew Farah (`afar1`).\n\nThe Field Theory repository family uses AGPL-3.0-or-later and MIT licenses unless a file or directory says otherwise.\n\n- AGPL: open source, including for commercial purposes. You may use, run, fork, modify, and redistribute the code, including commercially, under the license terms. If you modify Field Theory and offer it as a network service, AGPL requires you to provide the corresponding source for those modifications to users of that service.\n- MIT: permissive open source.\n\n## Repository Family\n\nField Theory is split across sibling repositories:\n\n- [`afar1/fieldtheory`](https://github.com/afar1/fieldtheory): Mac app source repository, licensed under AGPL-3.0-or-later.\n- [`afar1/fieldtheory-cli`](https://github.com/afar1/fieldtheory-cli): public CLI repo, licensed under MIT.\n- [`afar1/fieldtheory-plugin`](https://github.com/afar1/fieldtheory-plugin): plugin ecosystem repo, licensed under MIT.\n- [`afar1/field-releases`](https://github.com/afar1/field-releases): public binary release feed.\n\nThis repo is the public-facing app source repository. It is not the full private history archive.\n\n**Screens**\nNative editor (file over app)\n![Image](\u003cdocs/readme-assets/sha256-134f1a235aac54706082cd537335af0bfca3a439823745eb645b809d5c5f25fa.png\u003e)\nLocal X bookmark storage and viewer\n![Image](\u003cdocs/readme-assets/sha256-4557fa112d2d6257a2b14d644b9a6b6cecd0668735e9a6f3b100924066ac91ad.png\u003e)\nIntegrated terminal for collaborative writing with  Codex, Claude, and local models like Gemma\n![Image](\u003cdocs/readme-assets/sha256-455ba5eda3414c74f91fe713a02d6679b546fc35379a3caee18d5718bfa3118a.png\u003e)\nMultiple windows for comparative reaading\n![Image](\u003cdocs/readme-assets/sha256-3188053d1ea25d09a31364e9c6728e48202a8347b89e908f006a389e86762d92.png\u003e)\nContext launcher (shift command k) allows you to deploy md docs, bookmarks, or clipboard items into any front most application\n![Image](\u003cdocs/readme-assets/sha256-c22ac739d97525e4a6f97322bfd42fe405a035adbe9b17b0dea952f3b34b607a.png\u003e)\nEmojis in editor\n![Image](\u003cdocs/readme-assets/sha256-a59a42ac0aa59420851b8afe13459c1e8d7b1fcbf12551a2ea27c7278be87bfd.png\u003e)\nUse any markdown file as custom local command\n![Image](\u003cdocs/readme-assets/sha256-34fb41d3fab39267ba936fdd6f8d9810f72218589df2318f9c44a0495f6d8c11.png\u003e)\nFast, offline local voice transcription and context stacking (screenshots taken while you transcribe paste with transcript)\n![Image](\u003cdocs/readme-assets/sha256-25aee721e0dde1b9e1bb6e298ecdec4afdc58717dbd29809fcd3bd6b0c2ea119.png\u003e)\nPriority mic so your audio doesn't cut out when starting a transcription\n![Image](\u003cdocs/readme-assets/sha256-9537226e901b46865d6d783cdf0d75004bf85308601ccc10089f1c0302ebff63.png\u003e)\nFull clipboard manager with gmail-style shortcuts (j/k/s = stack/ u = unstack). All local\n![Image](\u003cdocs/readme-assets/sha256-600349c06e967f7f4ce8561eda3970ea4261ac70fe1ffdcbc2cbd8521d1e5b10.png\u003e)\n\n\n## History And Attribution\n\nSee [NOTICE.md](NOTICE.md) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for attribution and third-party notice tracking.\n\n## Public Source Boundary\n\nThis repo is intended to contain app source, local development docs, public governance docs, and public-facing architecture material.\n\nIt intentionally excludes production backend internals:\n\n- production Supabase schema;\n- Supabase migrations;\n- Supabase edge functions;\n- billing and service internals;\n- production Cloud configuration;\n- private operational runbooks;\n- hosted website/API route internals.\n\nPeople can read, run, fork, modify, and self-host Field Theory under the AGPL terms.\n\nThis source release does not include the production Field Theory Cloud backend, Supabase production internals, billing infrastructure, deployment configuration, or service secrets. Field Theory Cloud remains the official hosted service operated by Field Theory.\n\n## Where to Start\n\n- [Mac app README](mac-app/README.md): local development setup for the active Mac app.\n- [Mac app architecture](mac-app/docs/ARCHITECTURE.md): code-oriented map of the Electron app.\n- [Mac release workflow](mac-app/docs/RELEASE_WORKFLOW.md): maintainer packaging and release process.\n- [Privacy policy](mac-app/PRIVACY_POLICY.md): current Mac data-flow policy.\n- [Security policy](SECURITY.md): security reporting and sensitive-surface guidance.\n- [Third-party notices](THIRD_PARTY_NOTICES.md): dependency, model, and asset notice tracking.\n- [Architecture sketch](arch.md): useful historical map, but verify against code when accuracy matters.\n\n## Repository Shape\n\nThe active product center is `mac-app/`, an Electron + Vite + React macOS app.\n\nImportant Mac app areas:\n\n- `mac-app/src`: renderer UI.\n- `mac-app/electron/preload.ts`: renderer capability bridge.\n- `mac-app/electron/main`: privileged main-process code, IPC handlers, local data access, auth, sync, River, updater, and OS integration.\n- `mac-app/scripts`: development, build, native setup, packaging, and release helper scripts.\n- `mac-app/resources` and `mac-app/public`: packaged resources and static assets.\n\nThe public repository keeps the Mac app and supporting project documents at the top level. Archived mobile experiments and vendored Whisper sources are intentionally excluded.\n\n## Local Development\n\nFor the Mac app:\n\n```bash\ncd mac-app\nnpm ci\nnpm run dev\n```\n\nLocal verification:\n\n```bash\nnpm run typecheck\nnpm test\nnpm run build\n```\n\nSee [mac-app/README.md](mac-app/README.md) for details.\n\n## Local-First, Not Local-Only\n\nCore Mac app workflows can run without login. The app also has account-backed surfaces, including auth, feedback, account/quota checks, metrics, public sharing, River shared documents, and internally gated sync features.\n\n## License\n\nField Theory-owned app/source code in this repository is licensed under [AGPL-3.0-or-later](LICENSE).\n\nYou can use, run, fork, modify, and redistribute the code, including commercially, under the license terms. If someone modifies Field Theory and offers it as a network service, the AGPL requires them to provide the corresponding source for those modifications to users of that service.\n\nThe repo family uses a split-license model:\n\n- [`afar1/fieldtheory`](https://github.com/afar1/fieldtheory): AGPL-3.0-or-later for Field Theory-owned app/source code.\n- [`afar1/fieldtheory-cli`](https://github.com/afar1/fieldtheory-cli): MIT.\n- [`afar1/fieldtheory-plugin`](https://github.com/afar1/fieldtheory-plugin): MIT.\n- [`afar1/field-releases`](https://github.com/afar1/field-releases): public binary release feed.\n- Examples and protocol docs: MIT unless they are tightly app-coupled.\n- Brand assets: trademark protected.\n\nThe code license does not grant rights to the Field Theory name, logo, icon, brand, official Cloud service identity, or other trademarks. See [TRADEMARKS.md](TRADEMARKS.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafar1%2Ffieldtheory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fafar1%2Ffieldtheory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafar1%2Ffieldtheory/lists"}