{"id":31962068,"url":"https://github.com/specsmith-ai/specsmith-cli","last_synced_at":"2025-10-14T16:15:36.899Z","repository":{"id":312162453,"uuid":"1033201896","full_name":"specsmith-ai/specsmith-cli","owner":"specsmith-ai","description":"Specsmith CLI: Turn vague ideas into actionable specs with AI. Works with Jira, GitHub and coding agents.","archived":false,"fork":false,"pushed_at":"2025-09-02T14:30:16.000Z","size":152,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-29T16:36:05.509Z","etag":null,"topics":["ai","ai-agent","ai-agents","chat-application","chatbot","cli","github","github-integration","jira","jira-integration","python","specification","specification-generation","technical-specs"],"latest_commit_sha":null,"homepage":"https://specsmith.ai","language":"Python","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/specsmith-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2025-08-06T12:59:23.000Z","updated_at":"2025-09-02T13:32:50.000Z","dependencies_parsed_at":"2025-08-29T03:21:04.421Z","dependency_job_id":"02a241b0-3d51-439b-b41f-27ac7b43beed","html_url":"https://github.com/specsmith-ai/specsmith-cli","commit_stats":null,"previous_names":["specsmith-ai/specsmith-cli"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/specsmith-ai/specsmith-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specsmith-ai%2Fspecsmith-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specsmith-ai%2Fspecsmith-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specsmith-ai%2Fspecsmith-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specsmith-ai%2Fspecsmith-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/specsmith-ai","download_url":"https://codeload.github.com/specsmith-ai/specsmith-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specsmith-ai%2Fspecsmith-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019567,"owners_count":26086750,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"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":["ai","ai-agent","ai-agents","chat-application","chatbot","cli","github","github-integration","jira","jira-integration","python","specification","specification-generation","technical-specs"],"created_at":"2025-10-14T16:15:34.815Z","updated_at":"2025-10-14T16:15:36.885Z","avatar_url":"https://github.com/specsmith-ai.png","language":"Python","readme":"# Specsmith CLI\n\n\u003e **Forge clear specifications from product ideas.**\n\u003e *AI-powered agent for developers and builders.*\n\n[![PyPI version](https://badge.fury.io/py/specsmith-cli.svg)](https://badge.fury.io/py/specsmith-cli)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThe Specsmith CLI is a thin client for AI-powered specification generation using the Specsmith platform. Run `specsmith`, describe what you need, and get structured, implementation-ready technical specs.\n\n## 🚀 What is Specsmith?\n\nSpecsmith helps engineers move from rough ideas to actionable specifications. It asks clarifying questions, identifies ambiguities, and produces detailed specs designed to feed directly into AI coding agents or human implementation.\n\n### ✨ Key Capabilities\n\n* **🧠 Structured Specs**: From natural language to clear acceptance criteria \u0026 Definition of Done\n* **💬 Clarifying Conversations**: Interactive chat that refines requirements before finalizing\n* **📁 File Handling**: Create and update spec files right from the CLI\n* **⚡ Streaming Responses**: Real-time feedback as the AI reasons through your request\n* **🎯 Simple Entry Point**: Just run `specsmith` — no flags required\n\n## 🎯 Perfect For\n\n* Product managers defining features\n* Engineers planning implementations\n* Architects documenting systems\n* DevOps \u0026 infra teams writing technical runbooks\n\n## 📦 Installation\n\n```bash\npip install specsmith-cli\nspecsmith --version\n```\n\n## ⚡ Quickstart\n\n### 1. Get Your API Keys\n\nLearn more at [specsmith.ai](https://specsmith.ai) or go straight to [signup](https://app.specsmith.ai/signup) → **Settings** → **API Keys** → generate a new key pair.\n\n### 2. Configure Authentication\n\nRecommended:\n\n```bash\nspecsmith setup\n```\n\nAdvanced alternatives:\n\n* **Env vars**\n\n  ```bash\n  export SPECSMITH_ACCESS_KEY_ID=\"your-access-key-id\"\n  export SPECSMITH_ACCESS_KEY_TOKEN=\"your-access-key-token\"\n  ```\n* **Config file**\n\n  ```bash\n  mkdir -p ~/.specsmith\n  cat \u003e ~/.specsmith/credentials \u003c\u003c EOF\n  access_key_id=your-access-key-id\n  access_key_token=your-access-key-token\n  EOF\n  ```\n\n### 3. Test\n\n```bash\nspecsmith test\n```\n\n### 4. Start Workinggit add 0p\n\n\n```bash\nspecsmith\n```\n\nThat’s it — describe what you need, and specsmith will generate detailed specifications.\n\n## 🎨 Usage Examples\n\nInteractive session:\n\n```bash\nspecsmith\n```\n\nExample:\n\n```\nYou: I need a real-time chat app\n\nspecsmith: Let’s cover scale, features, tech stack, and platforms.\n...\n```\n\nFile management:\n\n```bash\n# Inside a chat session\n# ✓ Create new file: database-schema.sql? (y/n): y\n```\n\nConfiguration:\n\n```bash\nspecsmith config\n```\n\n## 🛠️ Advanced Features\n\n* **Custom API Endpoint**\n\n  ```bash\n  export SPECSMITH_API_URL=\"https://your.company/api\"\n  ```\n\n* **Debug Mode**\n\n  ```bash\n  specsmith --debug\n  ```\n\n* **Available Commands**\n\n  ```bash\n  specsmith chat      # start chat (default)\n  specsmith setup     # configure credentials\n  specsmith test      # test connection\n  specsmith config    # show current config\n  specsmith version   # version info\n  specsmith --help    # all options\n  ```\n\n## 🔧 Configuration Options\n\n| Variable                     | Description          | Default                    |\n| ---------------------------- | -------------------- | -------------------------- |\n| `SPECSMITH_ACCESS_KEY_ID`    | API key ID           | required                   |\n| `SPECSMITH_ACCESS_KEY_TOKEN` | API key token        | required                   |\n| `SPECSMITH_API_URL`          | API endpoint         | `https://api.specsmith.ai` |\n| `SPECSMITH_DEBUG`            | Enable debug logging | `false`                    |\n\nConfig sources (priority order):\n\n1. `~/.specsmith/credentials`\n2. Env vars\n3. CLI args\n\n## 🚀 Real-World Use Cases\n\n```bash\nspecsmith\n# \"Plan a notification system for a mobile app with push + email\"\n```\n\n```bash\nspecsmith\n# \"Design a REST API for a multi-tenant SaaS with RBAC\"\n```\n\n```bash\nspecsmith\n# \"Specify a CI/CD pipeline for microservices on Kubernetes\"\n```\n\n```bash\nspecsmith\n# \"Create a database schema for a social app with posts, comments, likes\"\n```\n\n## 🔍 Troubleshooting\n\n**Auth Errors**\n\n```bash\nspecsmith test\nspecsmith setup\n```\n\n**Connection Issues**\n\n```bash\ncurl -I https://api.specsmith.ai/health\nspecsmith test --debug\n```\n\n**File Permissions**\n\n```bash\nchmod 755 .\n```\n\nMore help:\n\n* Docs: [README](https://github.com/specsmith-ai/specsmith-cli#readme)\n* Issues: [GitHub](https://github.com/specsmith-ai/specsmith-cli/issues)\n* Website: [specsmith.ai](https://specsmith.ai)\n* Signup: [app.specsmith.ai/signup](https://app.specsmith.ai/signup)\n* Support: [support@specsmith.ai](mailto:support@specsmith.ai)\n\n## 📄 License\n\nMIT License — see [LICENSE](LICENSE)\n\n## 🌟 Why specsmith?\n\nGood code starts with good specs. specsmith makes your requirements:\n\n* **Complete**: No missing edge cases\n* **Actionable**: Ready for humans or AI agents\n* **Consistent**: Following best practices \u0026 standards\n* **Contextual**: Informed by your repo \u0026 architecture\n\n**Transform your workflow. Start with better specs.**\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[Get Started](https://specsmith.ai)** • **[Signup](https://app.specsmith.ai/signup)** • **[Docs](https://github.com/specsmith-ai/specsmith-cli#readme)**\n\nMade with ❤️ by specsmith\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecsmith-ai%2Fspecsmith-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspecsmith-ai%2Fspecsmith-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecsmith-ai%2Fspecsmith-cli/lists"}