{"id":50098981,"url":"https://github.com/rahmankarim/clientos","last_synced_at":"2026-05-23T06:06:28.846Z","repository":{"id":355300883,"uuid":"1227067894","full_name":"Rahmankarim/ClientOS","owner":"Rahmankarim","description":"ClientOS is an AI-powered project delivery platform for agencies and client-facing teams.","archived":false,"fork":false,"pushed_at":"2026-05-02T21:19:00.000Z","size":708,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T23:25:55.848Z","etag":null,"topics":["ai","ai-project","client","clientos","website"],"latest_commit_sha":null,"homepage":"","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/Rahmankarim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":null,"dco":null,"cla":null}},"created_at":"2026-05-02T06:43:52.000Z","updated_at":"2026-05-02T21:21:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Rahmankarim/ClientOS","commit_stats":null,"previous_names":["rahmankarim/clientos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Rahmankarim/ClientOS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahmankarim%2FClientOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahmankarim%2FClientOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahmankarim%2FClientOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahmankarim%2FClientOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rahmankarim","download_url":"https://codeload.github.com/Rahmankarim/ClientOS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rahmankarim%2FClientOS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33384606,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: 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":["ai","ai-project","client","clientos","website"],"created_at":"2026-05-23T06:06:25.860Z","updated_at":"2026-05-23T06:06:28.838Z","avatar_url":"https://github.com/Rahmankarim.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClientOS\n\nClientOS is an AI-powered project delivery platform for agencies and client-facing teams.\n\n## What This Website Does\n\nClientOS helps teams manage the full project lifecycle in one place:\n\n- Agency and client authentication with role-aware access\n- Proposal creation and approval flow\n- Automatic conversion of approved proposals into projects and milestones\n- Project dashboard with tasks, scope, and collaboration tools\n- Client portal for milestone visibility, deliverables, and feedback\n- GitHub integration with webhook-driven activity updates\n- AI endpoints for scope checks, milestone planning, and update generation\n\n## Why ClientOS Was Created\n\nMost project teams use disconnected tools for sales, delivery, code updates, and client communication. This creates delays, context loss, and trust issues.\n\nClientOS was created to solve that by providing:\n\n- A single delivery system from proposal to completion\n- Better visibility for clients without exposing internal complexity\n- AI assistance to speed up planning and communication\n- Clear, consistent project operations for small agencies and studios\n\n## Core User Flows\n\n1. Agency owner signs in and creates proposals or projects.\n2. Client receives access and reviews project status in a dedicated portal.\n3. Team syncs development activity and uses AI for delivery updates.\n4. Feedback and approvals are tracked in one system.\n\n## Tech Stack\n\n- Next.js (App Router) + TypeScript\n- NextAuth for authentication\n- MongoDB + Mongoose for data modeling and persistence\n- SWR for client data fetching\n- Tailwind CSS for UI styling\n- Groq API (free tier) for AI features\n\n## Environment Variables\n\nUse .env.example as the template for required configuration:\n\n- NEXTAUTH_URL\n- NEXTAUTH_SECRET\n- MONGODB_URI\n- GROQ_API_KEY (free tier)\n- Google OAuth keys (optional)\n- SMTP email keys for magic links\n- GitHub webhook and token settings\n\n## Running Locally\n\nInstall dependencies:\n\nnpm install\n\nStart development server:\n\nnpm run dev\n\nBuild for production:\n\nnpm run build\n\n## Notes\n\nSome legacy API routes may still need migration to the newer MongoDB helper naming conventions (connectToDatabase) if your build reports connectDB import errors.\n\"# ClientOS\"  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahmankarim%2Fclientos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahmankarim%2Fclientos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahmankarim%2Fclientos/lists"}