{"id":48273992,"url":"https://github.com/thesysdev/create-c1-app","last_synced_at":"2026-04-04T22:21:35.288Z","repository":{"id":318719225,"uuid":"1057900048","full_name":"thesysdev/create-c1-app","owner":"thesysdev","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-16T16:31:56.000Z","size":610,"stargazers_count":5,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-16T22:56:48.665Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thesysdev.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":"2025-09-16T11:01:57.000Z","updated_at":"2026-02-16T16:32:00.000Z","dependencies_parsed_at":"2025-10-11T22:18:00.401Z","dependency_job_id":"d4703f19-5ef8-4fc7-858b-61d32cb366b7","html_url":"https://github.com/thesysdev/create-c1-app","commit_stats":null,"previous_names":["thesysdev/create-c1-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thesysdev/create-c1-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesysdev%2Fcreate-c1-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesysdev%2Fcreate-c1-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesysdev%2Fcreate-c1-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesysdev%2Fcreate-c1-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thesysdev","download_url":"https://codeload.github.com/thesysdev/create-c1-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesysdev%2Fcreate-c1-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31416763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"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":[],"created_at":"2026-04-04T22:21:34.517Z","updated_at":"2026-04-04T22:21:35.278Z","avatar_url":"https://github.com/thesysdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Create C1 App\n\nA powerful CLI tool that setups Generative UI examples with C1 by Thesys\n\n## Features\n\n✨ **Interactive Project Setup**\n\n## Quick Start\n\n```bash\n# Run the tool\nnpx create-c1-app\n\n# With project name\nnpx create-c1-app my-thesys-project\n\n# With project name and options\nnpx create-c1-app my-thesys-project --template template-c1-component-next --api-key your-api-key\n```\n\n## CLI Options\n\n| Option                | Alias | Description                                                                                      | Default                                           |\n| --------------------- | ----- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------- |\n| `[project-name]`      |       | Name of the project to create (positional argument)                                              | Interactive prompt                                |\n| `--project-name`      | `-n`  | Name of the project to create (alternative to positional argument)                               | Interactive prompt                                |\n| `--template`          | `-t`  | Next.js template to use (`template-c1-component-next` or `template-c1-next`)                     | Interactive prompt                                |\n| `--api-key`           | `-k`  | Thesys API key to use for the project                                                            | Interactive prompt                                |\n| `--auth`              |       | Authentication method (`oauth`, `manual`, `skip`)                                                | Prompt in interactive mode; `oauth` when provided |\n| `--skip-auth`         |       | **Deprecated**. Use `--auth skip` instead                                                        | `false`                                           |\n| `--debug`             | `-d`  | Enable debug logging                                                                             | `false`                                           |\n| `--non-interactive`   |       | Run without prompts; fails fast if required options are missing. Auto-enabled in non-TTY shells. | `false` (auto-detected)                           |\n| `--disable-telemetry` |       | Disable anonymous telemetry for current session                                                  | `false`                                           |\n\n## Usage Examples\n\n### Basic Usage\n\n```bash\n# Interactive mode with OAuth authentication (recommended)\nnpx create-c1-app\n\n# Quick setup with project name as positional argument\nnpx create-c1-app my-thesys-project\n\n# Quick setup with project name, template, and API key\nnpx create-c1-app my-thesys-component --template template-c1-component-next --api-key your-api-key-here\n\n# Using flag instead of positional argument\nnpx create-c1-app --project-name my-thesys-component --template template-c1-component-next --api-key your-api-key-here\n\n# With specific template choice\nnpx create-c1-app my-project --template template-c1-next --api-key your-api-key-here\n\n# Interactive with API key provided\nnpx create-c1-app --api-key your-api-key-here\n```\n\n### Non-Interactive / CI / Agent Usage\n\nWhen running in CI pipelines, automated scripts, or AI agent shells (e.g. Cursor, Copilot, Devin), interactive prompts will hang. The CLI supports a fully non-interactive mode:\n\n```bash\n# Explicit flag\nnpx create-c1-app my-project --template template-c1-next --api-key YOUR_API_KEY --non-interactive\n\n# Or just provide all required flags — non-interactive mode is auto-detected\n# when stdin is not a TTY (pipes, agents, CI) or when CI env vars are set\nnpx create-c1-app my-project --template template-c1-next --api-key YOUR_API_KEY\n```\n\n**Auto-detection:** The CLI automatically enables non-interactive mode when:\n\n- `stdin` is not a TTY (piped input, background process, agent shell)\n\n**Behavior in non-interactive mode:**\n\n- `--api-key` is **required** (OAuth browser flow is skipped)\n- `--project-name` defaults to `my-c1-app` if not provided\n- `--template` defaults to `template-c1-next` if not provided\n- The CLI will **fail immediately** with a clear error if required options are missing, instead of hanging on a prompt\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/thesysdev/create-c1-app.git\ncd create-c1-app\npnpm install\npnpm run build\npnpm link\n```\n\n## Authentication Options\n\nCreate C1 App supports flexible authentication methods:\n\n### Option 1: OAuth 2.0 Authentication (Recommended)\n\nThe CLI will automatically open your browser and guide you through the OAuth authentication process. This is the default in interactive mode.\n\n```bash\nnpx create-c1-app\n# or explicitly:\nnpx create-c1-app --auth oauth\n```\n\nThis method will:\n\n- Open your browser for secure authentication\n- Generate an API key automatically after successful login\n- Store the API key in your project's `.env` file\n\nIf you do not pass an auth option in interactive mode, the CLI will ask you to choose between OAuth, manual API key entry, or skip.\n\n### Option 2: Manual API Key\n\nIf you prefer to enter your API key manually:\n\n```bash\nnpx create-c1-app --auth manual\n```\n\nOr provide your existing API key directly via flag:\n\n```bash\nnpx create-c1-app --api-key your-api-key-here\n```\n\n### Option 3: Skip Authentication\n\nTo skip authentication and API key generation (useful for testing or CI where you might set the key later):\n\n```bash\nnpx create-c1-app --auth skip\n```\n\n_Note: The `--skip-auth` flag is deprecated but still supported for backward compatibility. Use `--auth skip` going forward._\n\n## Getting Your Thesys API Key (Manual Method)\n\nTo get an API key manually:\n\n1. 🌐 Visit: https://console.thesys.dev/keys\n2. 🔐 Sign in to your Thesys account\n3. 🆕 Click \"Create New API Key\"\n4. 📝 Give your key a descriptive name\n5. 📋 Copy the generated API key\n\n💡 **Tip**: Keep your API key secure and never share it publicly!\n\n## Troubleshooting\n\n### Common Issues\n\n**Error: \"Project directory already exists\"**\n\n```bash\n# Choose a different name or remove the existing directory\nrm -rf existing-project-name\nnpx create-c1-app\n```\n\n**Error: \"Failed to download template\"**\n\n```bash\n# Check your internet connection and try again\nnpx create-c1-app\n```\n\n**Error: \"Failed to install dependencies\"**\n\n```bash\n# Navigate to your project and install manually\ncd your-project-name\nnpm install\n```\n\n### Debug Mode\n\nEnable debug logging for detailed troubleshooting:\n\n```bash\nnpx create-c1-app --debug\n```\n\nOr set the environment variable:\n\n```bash\nexport CREATE_C1_APP_DEBUG=true\nnpx create-c1-app\n```\n\n## Telemetry\n\ncreate-c1-app collects anonymous telemetry data to help improve the tool. No personally identifiable information is collected.\n\n### Managing Telemetry\n\n```bash\n# Disable for current session\nnpx create-c1-app --disable-telemetry\n\n# Disable via environment variable\nexport CREATE_C1_APP_DISABLE_TELEMETRY=true\n```\n\nFor complete details about what data is collected and how to control it, see [TELEMETRY.md](./TELEMETRY.md).\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- 🐛 [Issues](https://github.com/thesysdev/create-c1-app/issues)\n- 💬 [Discussions](https://github.com/thesysdev/create-c1-app/discussions)\n\n---\n\nMade with ❤️ by Thesys\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesysdev%2Fcreate-c1-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthesysdev%2Fcreate-c1-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesysdev%2Fcreate-c1-app/lists"}