{"id":51011613,"url":"https://github.com/jwill9999/agent-platform","last_synced_at":"2026-06-21T03:30:29.646Z","repository":{"id":351265469,"uuid":"1209696962","full_name":"jwill9999/agent-platform","owner":"jwill9999","description":"Agent Platform MVP — TypeScript harness, LangGraph, MCP, Docker, runtime, harness engineering,","archived":false,"fork":false,"pushed_at":"2026-06-20T15:29:47.000Z","size":14709,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-20T16:22:17.291Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jwill9999.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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-04-13T17:32:24.000Z","updated_at":"2026-05-23T23:24:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"72c1ce38-fc84-449d-9eb7-c91492277a7b","html_url":"https://github.com/jwill9999/agent-platform","commit_stats":null,"previous_names":["jwill9999/agent-platform"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jwill9999/agent-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fagent-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fagent-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fagent-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fagent-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jwill9999","download_url":"https://codeload.github.com/jwill9999/agent-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fagent-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34593128,"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-21T02:00:05.568Z","response_time":54,"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":[],"created_at":"2026-06-21T03:30:28.999Z","updated_at":"2026-06-21T03:30:29.631Z","avatar_url":"https://github.com/jwill9999.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent Platform\n\nComposable agent harness for building, configuring, and running AI agents. Built with Node.js, TypeScript, LangGraph, and the Model Context Protocol (MCP).\n\n## Quick Start\n\nPrerequisites: **Node.js 20** (see `.nvmrc`), **pnpm** 9+. The Makefile loads **nvm** when present and runs **`nvm install`** from the repo root so the **`.nvmrc`** version is installed (if needed) and selected before any `node`/`pnpm` step.\n\n### First time (prepare workspace, build, seed DB, run API + web)\n\nFrom the repo root:\n\n```bash\nmake\n```\n\nThis runs **`make up`** by default. The **`up`** target prepares the host workspace, builds the Docker images, starts the API and web containers, waits for healthchecks, then seeds demo data inside the API container.\n\nWhen complete:\n\n- **API:** `http://localhost:3000`\n- **Web:** `http://localhost:3001`\n- **Workspace:** host-backed under `.agent-platform/workspaces/default` for local development and mounted into the API container at `/workspace`\n\n## Current Capabilities\n\n- **Chat and agent runtime:** configurable agents, model configs, encrypted provider API keys, MCP server assignments, and NDJSON streaming through the API/web BFF.\n- **Settings UI:** management pages for agents, models, skills, tools, workspace files, memory, scheduler jobs, sessions, plugins, and MCP servers.\n- **Human-in-the-loop approvals:** risky or explicitly approval-required tools pause for user approval before execution and can resume safely after a decision.\n- **Workspace-aware coding tools:** repository discovery, git inspection, structured edits, quality gates, and guarded filesystem access inside the managed `/workspace`.\n- **Memory:** short-term working memory, review-gated long-term memories, memory candidates, approved prompt retrieval, Settings Memory review/export/cleanup, and a narrow self-learning evaluator.\n- **Scheduler:** durable local scheduled jobs with one-off and recurring schedules, pause/resume/run-now/edit/delete controls, persisted runs/logs, notifications, and safe built-in tasks.\n\n### Restart without wiping the database\n\nStops whatever is listening on the dev ports, then starts the stack again (rebuild, seed, run). Your **`SQLITE_PATH`** file (default `data/dev.sqlite`) is **not** deleted.\n\n```bash\nmake restart\n```\n\n### Full rebuild from scratch (destructive database)\n\nReinstalls dependencies, deletes the local dev SQLite file, rebuilds, seeds, and starts the stack. Use when you want a clean DB or after major schema changes.\n\n```bash\nmake new\n```\n\n### Other useful targets\n\n| Command                        | Purpose                                                                    |\n| ------------------------------ | -------------------------------------------------------------------------- |\n| `make up`                      | Prepare workspace, build, start API + web, seed DB                         |\n| `make down`                    | Stop containers while keeping Docker volumes and host workspace data       |\n| `make reset`                   | Wipe Docker DB/volumes, then rebuild, start, and seed                      |\n| `make workspace-init`          | Prepare host workspace/data directories without starting services          |\n| `make workspace-clean-dry-run` | Preview host workspace/data/config/log cleanup targets                     |\n| `make workspace-clean`         | Remove host workspace/data/config/log directories after typed confirmation |\n\nSee [Development Guide](docs/development.md) for prerequisites, env vars, tests, Docker, and the\ncurrent Electron desktop workflow.\n\n## Documentation\n\n| Guide                                                                    | Description                                                           |\n| ------------------------------------------------------------------------ | --------------------------------------------------------------------- |\n| [Architecture](docs/architecture.md)                                     | System design, package roles, data flow                               |\n| [Message Flow](docs/architecture/message-flow.md)                        | Mermaid diagrams: chat → security → LLM → tools                       |\n| [API Reference](docs/api-reference.md)                                   | REST endpoints, error shapes, schemas                                 |\n| [Database](docs/database.md)                                             | Schema, migrations, secret storage                                    |\n| [Development](docs/development.md)                                       | Local setup, build, test, lint commands                               |\n| [Deployment](docs/deployment.md)                                         | Docker, environment variables, production                             |\n| [Desktop Runtime](docs/desktop-runtime.md)                               | Electron desktop workflow, app data, logs, and limitations            |\n| [Configuration](docs/configuration.md)                                   | Env vars, model routing, limits, MCP, security                        |\n| [Workspace Storage](docs/workspace-storage.md)                           | Host workspace setup, security, cleanup, and validation               |\n| [Coding Runtime](docs/coding-runtime.md)                                 | Container CLI baseline and coding-agent policy                        |\n| [Scheduler](docs/scheduler.md)                                           | Durable scheduled jobs, background runs, logs, and notifications      |\n| [Memory Model](docs/memory.md)                                           | Implemented memory layers, review flow, retrieval, and retention      |\n| [Harness Gap Analysis](docs/planning/harness-gap-analysis-2026-04-29.md) | Capability gaps and recommended roadmap for coding/general automation |\n| [Memory Management](docs/planning/memory-management.md)                  | Short-term, long-term, and self-learning memory architecture          |\n| [Plugin Guide](docs/plugin-guide.md)                                     | Plugin hooks and authoring                                            |\n\n## Project Layout\n\n```\napps/api          Express REST API (port 3000)\napps/desktop      Electron shell and desktop runtime foundation\napps/web          Next.js chat UI (port 3001)\npackages/         Shared libraries (contracts, db, harness, model-router, mcp-adapter, etc.)\n  harness/src/security/  Security guards: PathJail, bash guard, injection/output/MCP trust guards\ndocs/             Documentation (architecture, API, config, message flow diagrams)\ne2e/              Playwright E2E tests\nscripts/          Workspace setup, cleanup, and compose verification helpers\n```\n\nSee [Architecture](docs/architecture.md) for the full package dependency graph.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines, and [AGENTS.md](AGENTS.md) for AI agent workflow instructions.\n\nTask tracking uses **bd (beads)** — see `AGENTS.md` for commands. Architectural decisions are recorded in [decisions.md](decisions.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwill9999%2Fagent-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjwill9999%2Fagent-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwill9999%2Fagent-platform/lists"}