Metadata-Version: 2.4
Name: cognix
Version: 0.2.0
Summary: AI-powered CLI development assistant
Author: Cognix
Maintainer: Cognix
License-Expression: Apache-2.0
Project-URL: Homepage, https://cognix-dev.github.io/cognix/
Project-URL: Repository, https://github.com/cognix-dev/cognix
Project-URL: Issues, https://github.com/cognix-dev/cognix/issues
Project-URL: Changelog, https://github.com/cognix-dev/cognix/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/cognix-dev/cognix/blob/main/README.md
Keywords: ai,cli,code-generation,llm,developer-tools,autonomous-coding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.0.0
Requires-Dist: anthropic>=0.5.0
Requires-Dist: pydantic>=1.10.0
Requires-Dist: rich>=13.0.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: toml>=0.10.2
Requires-Dist: typing-extensions>=4.7.0
Requires-Dist: pytest>=7.0.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: ruff>=0.1.0
Provides-Extra: lint-python
Requires-Dist: flake8>=6.1.0; extra == "lint-python"
Requires-Dist: ruff>=0.1.0; extra == "lint-python"
Requires-Dist: pylint>=3.0.0; extra == "lint-python"
Provides-Extra: lint-all
Requires-Dist: cognix[lint-python]; extra == "lint-all"
Dynamic: license-file

# Cognix

Autonomous code generation powered by flow engineering.

[![Version](https://img.shields.io/badge/version-0.2.0-blue.svg)](https://github.com/cognix-dev/cognix)
[![License](https://img.shields.io/badge/license-Apache_2.0-green.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)

---

## Installation

```bash
pipx install cognix
```

or `pip install cognix`. Requires Python 3.9+.

For Windows binary installation, see [INSTALL.md](INSTALL.md).

---

## Quick Start

```bash
# Setup API key
echo "ANTHROPIC_API_KEY=your_key" > .env

# Run
cognix

# Generate code from a spec file (sample included)
cognix> /make @sample_spec_tetris.md

# Or describe what you want
cognix> /make "landing page with HTML and CSS"
```

A sample spec file `sample_spec_tetris.md` is included in the repository. Use it as a reference for writing your own specs.

For available commands, type `/help` in the CLI.

Linting with `ruff` is included by default. Additional linters (`flake8`, `pylint`) are auto-detected if installed.

### Windows binary

Download `cognix.exe` from [Releases](https://github.com/cognix-dev/cognix/releases). No Python installation required.

---

## Model Configuration

### Anthropic Claude (Default)

```bash
ANTHROPIC_API_KEY=sk-ant-your_key
# Supports: Sonnet 4.5 (default), Opus 4.5
```

### OpenAI

```bash
OPENAI_API_KEY=sk-your_key
# Supports: GPT-5.2, GPT-5.2 Codex
```

### OpenRouter

```bash
OPENAI_API_KEY=sk-or-v1-your_key
OPENAI_BASE_URL=https://openrouter.ai/api/v1
```

### Switch models

```bash
cognix> /model
```

---

## MCP Server Integration

Use Cognix from Claude Desktop, Cursor, VSCode, or any MCP-compatible tool.

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cognix": {
      "command": "cognix-mcp"
    }
  }
}
```

---

## Data Storage

```
~/.cognix/
├── config.json            # Settings
├── memory.json            # Conversation & project memory
├── repository_data.json   # Repository analysis data
├── ui-knowledge.json      # UI knowledge base
├── sessions/              # Saved sessions
├── knowledge/             # App pattern definitions
├── rules/                 # File reference rules
├── backups/               # Automatic backups
└── impact_analysis/       # Impact analysis results
```

No telemetry. API calls only to configured LLM provider.

---

## Links

**GitHub**: [github.com/cognix-dev/cognix](https://github.com/cognix-dev/cognix)
**Issues**: [GitHub Issues](https://github.com/cognix-dev/cognix/issues)
**Discussions**: [GitHub Discussions](https://github.com/cognix-dev/cognix/discussions)

---

## License

Apache-2.0 License - see [LICENSE](LICENSE) file
