Metadata-Version: 2.4
Name: newcode
Version: 0.2.4
Summary: AI-powered code generation agent platform
Project-URL: repository, https://github.com/janfeddersen-wq/new_code
Project-URL: HomePage, https://github.com/janfeddersen-wq/new_code
Project-URL: Upstream, https://github.com/mpfaffenberger/code_puppy
Author: Jan Feddersen, Michael Pfaffenberger (original code-puppy author)
License: MIT
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: <3.14,>=3.11
Requires-Dist: anthropic==0.79.0
Requires-Dist: dbos>=2.11.0
Requires-Dist: fastapi>=0.109.0
Requires-Dist: httpx[http2]>=0.24.1
Requires-Dist: json-repair>=0.46.2
Requires-Dist: mcp>=1.9.4
Requires-Dist: openai>=1.99.1
Requires-Dist: pillow>=10.0.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: prompt-toolkit>=3.0.52
Requires-Dist: pydantic-ai-slim[anthropic,mcp,openai]==1.56.0
Requires-Dist: pydantic>=2.4.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rapidfuzz>=3.13.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.4.2
Requires-Dist: ripgrep==14.1.0
Requires-Dist: tenacity>=8.2.0
Requires-Dist: termflow-md>=0.1.8
Requires-Dist: typer>=0.12.0
Requires-Dist: uvicorn[standard]>=0.27.0
Requires-Dist: websockets>=12.0
Description-Content-Type: text/markdown

# NewCode

**NewCode** is an open-source, terminal-first AI coding agent for generating, editing, and reviewing code directly from your CLI.

It is maintained as a fork of [code-puppy](https://github.com/mpfaffenberger/code_puppy), with a more professional default UX and workflow-focused agent setup.

## Why NewCode

NewCode is designed for practical software workflows in the terminal: inspect files, make edits, run commands, and iterate quickly with AI assistance.

## Features

- Multi-provider model support (including OpenAI, Anthropic, Gemini, Cerebras, and compatible OpenAI-style endpoints)
- Terminal-first coding workflow (read/search/edit/delete files and run commands)
- Built-in agent system with a default coding agent and optional specialist workflows
- MCP (Model Context Protocol) integration and server management
- Interactive command-driven UX for model, agent, and settings management
- Session autosave/restore and scheduler utilities
- Plugin/callback extensibility hooks

## Quick start

### 1) Install

```bash
pip install newcode
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv pip install newcode
```

### 2) Launch

```bash
newcode
```

Short alias:

```bash
nc
```

On first run, NewCode starts onboarding to help configure API keys and defaults.

### 3) First useful commands

```bash
/config         # Show current configuration
/model          # Select or switch model
/agent          # Select or switch agent
/scheduler      # Manage scheduled tasks
/colors         # Customize terminal UI colors
/api            # Manage built-in API server (start|stop|status)
```

## Requirements

- Python `>=3.11,<3.14`
- At least one provider/API key for a supported model backend

## Configuration

NewCode uses a legacy-compatible config filename: `puppy.cfg`.

- Default path: `~/.newcode/puppy.cfg`
- With XDG variables: `$XDG_CONFIG_HOME/newcode/puppy.cfg`

## Development

```bash
git clone https://github.com/janfeddersen-wq/new_code.git
cd new_code
uv pip install -e ".[dev]"
```

## Testing

Run the test suite:

```bash
uv run pytest tests/ -v
```

Run linting and formatting checks:

```bash
ruff check .
ruff format --check .
```

## Contributing

Contributions are welcome.

- Open an issue to discuss bugs, ideas, or improvements.
- Submit a pull request with a clear scope and rationale.
- Keep changes focused and include tests when applicable.

## License

MIT — see [LICENSE](LICENSE).
