{"id":51546330,"url":"https://github.com/forepath/one","last_synced_at":"2026-07-09T18:32:09.930Z","repository":{"id":318745398,"uuid":"1063628974","full_name":"forepath/one","owner":"forepath","description":"Central open source monorepo for ForePath One: shared platform services, applications, and Nx workspace tooling.","archived":false,"fork":false,"pushed_at":"2026-07-08T21:03:27.000Z","size":18964,"stargazers_count":1,"open_issues_count":51,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-08T21:10:52.849Z","etag":null,"topics":["angular","bootstrap","clarity","forepath","framework","ionic","keycloak","nestjs","tsef","typescript"],"latest_commit_sha":null,"homepage":"https://forepath.io/one","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/forepath.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":".github/CODEOWNERS","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":null,"dco":null,"cla":null}},"created_at":"2025-09-24T22:34:48.000Z","updated_at":"2026-07-08T21:03:42.000Z","dependencies_parsed_at":"2026-05-16T13:01:27.560Z","dependency_job_id":null,"html_url":"https://github.com/forepath/one","commit_stats":null,"previous_names":["forepath/tsef","forepath/agenstra"],"tags_count":136,"template":false,"template_full_name":null,"purl":"pkg:github/forepath/one","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forepath%2Fone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forepath%2Fone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forepath%2Fone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forepath%2Fone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/forepath","download_url":"https://codeload.github.com/forepath/one/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/forepath%2Fone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35309827,"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-07-09T02:00:07.329Z","response_time":57,"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":["angular","bootstrap","clarity","forepath","framework","ionic","keycloak","nestjs","tsef","typescript"],"created_at":"2026-07-09T18:32:09.087Z","updated_at":"2026-07-09T18:32:09.920Z","avatar_url":"https://github.com/forepath.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv style=\"text-align: center;\"\u003e\n\n[![GitHub](https://img.shields.io/badge/GitHub-forepath%2Fone-181717?style=flat\u0026logo=github\u0026logoColor=white)](https://github.com/forepath/one)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Nx](https://img.shields.io/badge/powered%20by-Nx-143055?style=flat\u0026logo=nx\u0026logoColor=white)](https://nx.dev)\n[![Cursor](https://img.shields.io/badge/Cursor-IDE-FFB500?style=flat\u0026logo=cursor\u0026logoColor=white)](https://www.cursor.so)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Angular](https://img.shields.io/badge/Angular-DD0031?style=flat\u0026logo=angular\u0026logoColor=white)](https://angular.io)\n[![NestJS](https://img.shields.io/badge/NestJS-E0234E?style=flat\u0026logo=nestjs\u0026logoColor=white)](https://nestjs.com/)\n\n\u003c/div\u003e\n\n# ForePath One\n\n**The central open source monorepo for ForePath products and shared platform code.**\n\nThis repository hosts the software that powers [ForePath One](https://forepath.io/one), the umbrella for ForePath open source products. Today it contains the company website, the Agenstra agent governance platform, shared authentication and MCP tooling, and the Nx workspace infrastructure that ties them together. Each product lives in a named domain under `apps/` and `libs/domains/`, with per-component licenses where sublicensing applies.\n\n## Repository overview\n\nClone and install dependencies from the repository root:\n\n```bash\ngit clone https://github.com/forepath/one.git\ncd one\nnpm install\n```\n\nApplications and libraries are grouped by product domain. Nx project names use a domain prefix (for example `agenstra-backend-agent-manager` or `forepath-frontend-landingpage`).\n\n| Domain     | Role                                                                              | Applications (`apps/\u003cdomain\u003e/`)                                                 | Libraries (`libs/domains/\u003cdomain\u003e/`)                                    |\n| ---------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |\n| `forepath` | ForePath company website, marketing features, and internal communication services | `frontend-landingpage`, `backend-communication`                                 | `frontend/feature-landingpage`, `backend/feature-communication-manager` |\n| `agenstra` | Agent governance platform (console, controllers, managers, docs, desktop client)  | Agent console, controllers, managers, docs, landing page, native desktop client | Feature, data-access, and utility libraries for Agenstra                |\n| `decabill` | Billing and subscription management product                                       | Backend billing manager, frontend billing console                               | Feature and data-access libraries for Decabill                          |\n| `shared`   | Cross-product platform services                                                   | Platform authentication (Keycloak), MCP devkit, MCP proxy                       | Monitoring, configuration, Express SSR utilities, queue, crypto         |\n| `identity` | Authentication shared across products                                             | none                                                                            | Keycloak integration for backend and frontend                           |\n\nWorkspace tooling under `tools/` (`code`, `ai`, `sbom`, `release-integrity`) supports generators, agent context, and release automation. It is covered by the root MIT license unless noted otherwise in the component.\n\n## Projects\n\n### ForePath\n\nThe ForePath domain contains the public company website at [forepath.io](https://forepath.io). It presents consulting, IT systems, software development services, and the ForePath One product portfolio. The site is an Angular SSR application with localized routes for home, services, pricing, legal pages, and the ForePath One overview.\n\n| Component                 | Nx project                                       | Path                                                                                                                            | Description                                                 |\n| ------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |\n| Landing page application  | `forepath-frontend-landingpage`                  | [`apps/forepath/frontend-landingpage`](./apps/forepath/frontend-landingpage/)                                                   | Angular SSR shell, Express server, Docker deployment        |\n| Communication API         | `forepath-backend-communication`                 | [`apps/forepath/backend-communication`](./apps/forepath/backend-communication/)                                                 | Public contact request proxy to Chatwoot (internal)         |\n| Marketing feature library | `forepath-frontend-feature-landingpage`          | [`libs/domains/forepath/frontend/feature-landingpage`](./libs/domains/forepath/frontend/feature-landingpage/)                   | Pages, layout, routes, and content for the ForePath website |\n| Communication feature lib | `forepath-backend-feature-communication-manager` | [`libs/domains/forepath/backend/feature-communication-manager`](./libs/domains/forepath/backend/feature-communication-manager/) | Chatwoot proxy module and OpenAPI spec                      |\n\nRun the site locally:\n\n```bash\nnx serve forepath-frontend-landingpage\n```\n\n### Agenstra\n\n[Agenstra](https://agenstra.com) is a centralized control plane for managing distributed AI agent infrastructure. It lets platform teams connect to remote agent-manager services, interact with agents in real time, edit code in containers, provision servers, and operate tickets, knowledge, and billing from a single web console or optional desktop client.\n\nAgenstra follows a three-tier distributed architecture:\n\n```mermaid\nflowchart TB\n  FE[\"Frontend Console\u003cbr/\u003e(Web-based IDE)\u003cbr/\u003eAngular, NgRx, Monaco Editor,\u003cbr/\u003eChat Interface, File Management\"]\n  AC[\"Agent Controller\u003cbr/\u003e(Backend)\u003cbr/\u003eCentralized control plane\u003cbr/\u003eClient management, event forwarding\"]\n  AM[\"Agent Manager\u003cbr/\u003e(Backend)\u003cbr/\u003eAgent lifecycle management\u003cbr/\u003eContainer management, Docker integration\"]\n\n  FE --\u003e|\"HTTP REST API\u003cbr/\u003eWebSocket (Socket.IO)\"| AC\n  AC --\u003e|\"HTTP REST API\u003cbr/\u003eWebSocket (Socket.IO)\"| AM\n```\n\n| Component                | Nx project                          | Path                                                                                                                                     | Description                                                  |\n| ------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |\n| Frontend agent console   | `agenstra-frontend-agent-console`   | [`apps/agenstra/frontend-agent-console`](./apps/agenstra/frontend-agent-console/)                                                        | Web-based IDE, chat, file management, tickets, knowledge     |\n| Native agent console     | `agenstra-native-agent-console`     | [`apps/agenstra/native-agent-console`](./apps/agenstra/native-agent-console/)                                                            | Electron desktop shell around the agent console              |\n| Backend agent controller | `agenstra-backend-agent-controller` | [`apps/agenstra/backend-agent-controller`](./apps/agenstra/backend-agent-controller/)                                                    | Control plane for clients, tickets, proxying, and statistics |\n| Backend agent manager    | `agenstra-backend-agent-manager`    | [`apps/agenstra/backend-agent-manager`](./apps/agenstra/backend-agent-manager/)                                                          | Agent lifecycle, Docker workloads, VNC, SSH, worker images   |\n| Frontend docs            | `agenstra-frontend-docs`            | [`apps/agenstra/frontend-docs`](./apps/agenstra/frontend-docs/) (patch over [`apps/shared/frontend-docs`](./apps/shared/frontend-docs/)) | In-product documentation site                                |\n| Frontend landing page    | `agenstra-frontend-landingpage`     | [`apps/agenstra/frontend-landingpage`](./apps/agenstra/frontend-landingpage/)                                                            | Public Agenstra marketing and pricing site                   |\n\nKey Agenstra capabilities include centralized management of remote agent-manager instances, WebSocket-based agent chat, Monaco Editor file editing in containers, automated cloud server provisioning (Hetzner Cloud, DigitalOcean), Git operations from the browser, container monitoring and logs, VNC browser access, and CI/CD pipeline management from the console.\n\nTo get started with Agenstra:\n\n1. Follow the [Getting Started Guide](./docs/agenstra/getting-started.md) to install and configure the stack.\n2. Create your first client by connecting to an existing agent-manager or provisioning a new server.\n3. Create an agent and explore the integrated editor, Git tools, and chat interface.\n\n### Decabill\n\nDecabill is the ForePath billing product for subscriptions, invoicing, payment processing, and customer billing administration. The **billing manager** (backend API and jobs) is sublicensed under [AGPL-3.0](./apps/decabill/backend-billing-manager/LICENSE). The **billing console** (Angular UI) is sublicensed under [BUSL-1.1](./apps/decabill/frontend-billing-console/LICENSE) with an Additional Use Grant for qualifying startups.\n\n| Component                | Nx project                          | Path                                                                                                                                     | Description                                  |\n| ------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |\n| Backend billing manager  | `decabill-backend-billing-manager`  | [`apps/decabill/backend-billing-manager`](./apps/decabill/backend-billing-manager/)                                                      | Subscriptions, invoicing, Stripe integration |\n| Frontend billing console | `decabill-frontend-billing-console` | [`apps/decabill/frontend-billing-console`](./apps/decabill/frontend-billing-console/)                                                    | Admin and customer billing UI                |\n| Frontend docs            | `decabill-frontend-docs`            | [`apps/decabill/frontend-docs`](./apps/decabill/frontend-docs/) (patch over [`apps/shared/frontend-docs`](./apps/shared/frontend-docs/)) | In-product documentation site                |\n\n### Shared platform\n\nShared applications and libraries are used by multiple ForePath products. They cover authentication, AI agent development tooling, monitoring, and common frontend server utilities.\n\n| Component               | Nx project                       | Path                                                                            | Description                                                |\n| ----------------------- | -------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------- |\n| Platform authentication | `shared-platform-authentication` | [`apps/shared/platform-authentication`](./apps/shared/platform-authentication/) | Keycloak Docker Compose for local and shared auth          |\n| MCP devkit              | `shared-mcp-devkit`              | [`apps/shared/mcp-devkit`](./apps/shared/mcp-devkit/)                           | Model Context Protocol server for workspace and Nx tooling |\n| MCP proxy               | `shared-mcp-proxy`               | [`apps/shared/mcp-proxy`](./apps/shared/mcp-proxy/)                             | Proxy that routes MCP clients to the devkit                |\n| Frontend docs (base)    | `shared-frontend-docs`           | [`apps/shared/frontend-docs`](./apps/shared/frontend-docs/)                     | Shared SSR docs shell used by brand patch apps             |\n\nIdentity libraries under [`libs/domains/identity`](./libs/domains/identity/) provide Keycloak-backed authentication for NestJS backends and Angular frontends across Agenstra and future products.\n\n## Documentation\n\n### ForePath and workspace\n\n- [Contributing Guide](./CONTRIBUTING.md) applies to the whole monorepo.\n\n### Agenstra\n\n- [Getting Started Guide](./docs/agenstra/getting-started.md)\n- [Local Development](./docs/agenstra/deployment/local-development.md)\n- [System Overview](./docs/agenstra/architecture/system-overview.md)\n- [Components](./docs/agenstra/architecture/components.md)\n- [Docker Deployment](./docs/agenstra/deployment/docker-deployment.md)\n- [Environment Configuration](./docs/agenstra/deployment/environment-configuration.md)\n- [API Reference](./docs/agenstra/api-reference/README.md)\n- [Common Issues](./docs/agenstra/troubleshooting/common-issues.md)\n- [Debugging Guide](./docs/agenstra/troubleshooting/debugging-guide.md)\n\nFeature guides (client management, agent management, server provisioning, WebSocket communication, file management, version control, web IDE, chat, VNC access) live under [`docs/agenstra/features/`](./docs/agenstra/features/).\n\n### Decabill\n\n- [Getting Started Guide](./docs/decabill/getting-started.md)\n- [System Overview](./docs/decabill/architecture/system-overview.md)\n- [Docker Deployment](./docs/decabill/deployment/docker-deployment.md)\n- [Environment Configuration](./docs/decabill/deployment/environment-configuration.md)\n- [API Reference](./docs/decabill/api-reference/README.md)\n- [Security documentation](./docs/decabill/security/README.md)\n\nFeature guides (subscriptions, invoices, billing administration, multi-tenancy, payments, server provisioning) live under [`docs/decabill/features/`](./docs/decabill/features/).\n\n## License\n\nThe repository default is the **MIT License**. See [LICENSE](./LICENSE) for the full text.\n\nCopyright (c) 2025 IPvX UG (haftungsbeschränkt)\n\nPortions of this software were originally Copyright (c) 2017-2025 Narwhal Technologies Inc.\n\nIndividual applications and libraries may be sublicensed. Always check the LICENSE file in each component before use, modification, or distribution.\n\n### GNU Affero General Public License v3.0 (AGPL-3.0)\n\nThe following components are sublicensed under AGPL-3.0. Modifications and derivative works must remain under AGPL-3.0 and must be made available to users, including when accessed over a network.\n\n- [`apps/agenstra/backend-agent-manager`](./apps/agenstra/backend-agent-manager/) ([LICENSE](./apps/agenstra/backend-agent-manager/LICENSE))\n- [`libs/domains/agenstra/backend/feature-agent-manager`](./libs/domains/agenstra/backend/feature-agent-manager/) ([LICENSE](./libs/domains/agenstra/backend/feature-agent-manager/LICENSE))\n- [`libs/domains/shared/backend/feature-monitoring`](./libs/domains/shared/backend/feature-monitoring/) ([LICENSE](./libs/domains/shared/backend/feature-monitoring/LICENSE))\n- [`apps/agenstra/frontend-agent-console`](./apps/agenstra/frontend-agent-console/) ([LICENSE](./apps/agenstra/frontend-agent-console/LICENSE))\n- [`libs/domains/agenstra/frontend/feature-agent-console`](./libs/domains/agenstra/frontend/feature-agent-console/) ([LICENSE](./libs/domains/agenstra/frontend/feature-agent-console/LICENSE))\n- [`libs/domains/agenstra/frontend/data-access-agent-console`](./libs/domains/agenstra/frontend/data-access-agent-console/) ([LICENSE](./libs/domains/agenstra/frontend/data-access-agent-console/LICENSE))\n- [`libs/domains/shared/frontend/util-configuration`](./libs/domains/shared/frontend/util-configuration/) ([LICENSE](./libs/domains/shared/frontend/util-configuration/LICENSE))\n- [`libs/domains/shared/frontend/util-cookie-consent`](./libs/domains/shared/frontend/util-cookie-consent/) ([LICENSE](./libs/domains/shared/frontend/util-cookie-consent/LICENSE))\n- [`libs/domains/shared/frontend/util-express-server`](./libs/domains/shared/frontend/util-express-server/) ([LICENSE](./libs/domains/shared/frontend/util-express-server/LICENSE))\n- [`libs/domains/agenstra/frontend/util-docs-parser`](./libs/domains/agenstra/frontend/util-docs-parser/) ([LICENSE](./libs/domains/agenstra/frontend/util-docs-parser/LICENSE))\n- [`libs/domains/shared/frontend/util-runtime-config-server`](./libs/domains/shared/frontend/util-runtime-config-server/) ([LICENSE](./libs/domains/shared/frontend/util-runtime-config-server/LICENSE))\n- [`libs/domains/shared/frontend/util-meta`](./libs/domains/shared/frontend/util-meta/) ([LICENSE](./libs/domains/shared/frontend/util-meta/LICENSE))\n- [`libs/domains/shared/backend/util-http-context`](./libs/domains/shared/backend/util-http-context/) ([LICENSE](./libs/domains/shared/backend/util-http-context/LICENSE))\n- [`apps/decabill/backend-billing-manager`](./apps/decabill/backend-billing-manager/) ([LICENSE](./apps/decabill/backend-billing-manager/LICENSE))\n- [`libs/domains/decabill/backend/feature-billing-manager`](./libs/domains/decabill/backend/feature-billing-manager/) ([LICENSE](./libs/domains/decabill/backend/feature-billing-manager/LICENSE))\n\n### Business Source License 1.1 (BUSL-1.1)\n\nThe following components are sublicensed under BUSL-1.1. They permit non-production use and limited production use subject to the Additional Use Grant. The license converts to AGPL-3.0 after the Change Date (three years from release date).\n\n- [`apps/agenstra/backend-agent-controller`](./apps/agenstra/backend-agent-controller/) ([LICENSE](./apps/agenstra/backend-agent-controller/LICENSE))\n- [`libs/domains/agenstra/backend/feature-agent-controller`](./libs/domains/agenstra/backend/feature-agent-controller/) ([LICENSE](./libs/domains/agenstra/backend/feature-agent-controller/LICENSE))\n- [`apps/decabill/frontend-billing-console`](./apps/decabill/frontend-billing-console/) ([LICENSE](./apps/decabill/frontend-billing-console/LICENSE))\n- [`libs/domains/decabill/frontend/feature-billing-console`](./libs/domains/decabill/frontend/feature-billing-console/) ([LICENSE](./libs/domains/decabill/frontend/feature-billing-console/LICENSE))\n- [`libs/domains/decabill/frontend/data-access-billing-console`](./libs/domains/decabill/frontend/data-access-billing-console/) ([LICENSE](./libs/domains/decabill/frontend/data-access-billing-console/LICENSE))\n\n### Source-available license\n\nThe following components are source-available. You may view the source code to understand how the software works. No other rights are granted, including copying, modifying, distributing, or running the software.\n\n**ForePath domain**\n\n- [`apps/forepath/frontend-landingpage`](./apps/forepath/frontend-landingpage/) ([LICENSE](./apps/forepath/frontend-landingpage/LICENSE))\n- [`apps/forepath/backend-communication`](./apps/forepath/backend-communication/) ([LICENSE](./apps/forepath/backend-communication/LICENSE))\n- [`libs/domains/forepath/frontend/feature-landingpage`](./libs/domains/forepath/frontend/feature-landingpage/) ([LICENSE](./libs/domains/forepath/frontend/feature-landingpage/LICENSE))\n- [`libs/domains/forepath/backend/feature-communication-manager`](./libs/domains/forepath/backend/feature-communication-manager/) ([LICENSE](./libs/domains/forepath/backend/feature-communication-manager/LICENSE))\n\n**Agenstra domain**\n\n- [`apps/agenstra/frontend-landingpage`](./apps/agenstra/frontend-landingpage/) ([LICENSE](./apps/agenstra/frontend-landingpage/LICENSE))\n- [`libs/domains/agenstra/frontend/feature-landingpage`](./libs/domains/agenstra/frontend/feature-landingpage/) ([LICENSE](./libs/domains/agenstra/frontend/feature-landingpage/LICENSE))\n- [`apps/agenstra/frontend-docs`](./apps/agenstra/frontend-docs/) ([LICENSE](./apps/agenstra/frontend-docs/LICENSE))\n- [`apps/decabill/frontend-docs`](./apps/decabill/frontend-docs/) ([LICENSE](./apps/decabill/frontend-docs/LICENSE))\n- [`apps/shared/frontend-docs`](./apps/shared/frontend-docs/) ([LICENSE](./apps/shared/frontend-docs/LICENSE))\n- [`libs/domains/shared/frontend/feature-docs`](./libs/domains/shared/frontend/feature-docs/) ([LICENSE](./libs/domains/shared/frontend/feature-docs/LICENSE))\n- [`libs/domains/agenstra/frontend/data-access-portal`](./libs/domains/agenstra/frontend/data-access-portal/) ([LICENSE](./libs/domains/agenstra/frontend/data-access-portal/LICENSE))\n\n## Contributing\n\nWe welcome contributions across the monorepo, including bug fixes, features, documentation, tests, and design improvements for Agenstra, shared platform code, and workspace tooling.\n\nPlease read [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions, coding standards, and the pull request process. Use [GitHub Discussions](https://github.com/forepath/one/discussions) for questions and [GitHub Issues](https://github.com/forepath/one/issues) for bugs and feature requests.\n\nWhen contributing to a sublicensed component, ensure your changes comply with that component's license terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforepath%2Fone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fforepath%2Fone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fforepath%2Fone/lists"}