AI-powered code generation agent platform
Project description
NewCode
An AI-powered code generation and modification agent for the terminal.
NewCode is a fork of code-puppy by Michael Pfaffenberger, customized for the fedstew workflow. We wanted a clean, professional CLI agent with opinionated defaults, streamlined prompts, and a focus on practical code generation without the playful branding.
What changed from code-puppy
- Removed all dog/puppy-themed branding and emojis in favor of a clean, professional interface
- Renamed "Pack" multi-agent system to use functional names (Orchestrator, Tracker, Executor, Reviewer, etc.)
- Rewrote all agent system prompts for clarity and professionalism
- Increased output validation retries from 3 to 10 for more robust model interactions
- Updated configuration keys and display names throughout
- Published to PyPI as
newcodeinstead ofcode-puppy
Installation
pip install newcode
Or with uv:
uv pip install newcode
Quick Start
# Run the agent
newcode
# Or use the short alias
nc
On first run, you'll be guided through a setup wizard to configure your API keys and preferences.
Requirements
- Python 3.11 - 3.13
- An API key for at least one supported provider (OpenAI, Anthropic, Cerebras, Google Gemini, etc.)
Features
- Multi-model support: OpenAI, Anthropic Claude, Google Gemini, Cerebras, and more
- Multi-agent workflows with specialized agents (Orchestrator, Tracker, Executor, Reviewer, QA Checker, Workspace Manager, Merger)
- File operations: read, write, edit, delete with diff previews and permission prompts
- Shell command execution with safety controls
- Browser-based terminal via built-in API server
- Scheduled task execution with a background daemon
- Plugin system with lifecycle callbacks and event-based hooks
- Interactive TUI menus for configuration, model selection, and task management
- Session auto-save and restore
- MCP (Model Context Protocol) server support
Configuration
Configuration is stored in ~/.config/newcode/puppy.cfg (XDG-compliant paths). The setup wizard handles initial configuration. You can also use CLI commands:
# Inside the agent REPL:
/config # Show current configuration
/model # Switch models
/agent # Switch agents
/scheduler # Manage scheduled tasks
/colors # Customize terminal colors
Agents
| Agent | Purpose |
|---|---|
| Code Agent | General-purpose code generation and modification (default) |
| Orchestrator | Multi-agent workflow coordination |
| Tracker | Code search and navigation |
| Executor | Shell command execution |
| Reviewer | Code review and quality checks |
| QA Checker | Testing and validation |
| Workspace Manager | File system operations |
| Merger | Result integration |
| Python Reviewer | Python-specific code review |
| QA Expert | Testing strategy and quality assurance |
| Security Auditor | Security analysis |
Development
# Clone the repo
git clone https://github.com/janfeddersen-wq/new_code.git
cd new_code
# Install with dev dependencies
uv pip install -e ".[dev]"
# Run tests
uv run pytest tests/ -v
# Lint
ruff check .
ruff format --check .
Credits
This project is a fork of code-puppy by Michael Pfaffenberger, licensed under the MIT License. We are grateful for the original work and the open-source foundation it provides.
License
MIT License - see LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file newcode-0.1.10.tar.gz.
File metadata
- Download URL: newcode-0.1.10.tar.gz
- Upload date:
- Size: 709.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b17c214a6a3ac5f293ceae372c0ca2471f92d1bb401229ea26373566cecf71ca
|
|
| MD5 |
8998d09c9234118fa096af1c596f62d6
|
|
| BLAKE2b-256 |
5b85924a0b4b9aefd9ee6da64a8e95a0046fb741a33f2ae911a42dfcd9ff0721
|
Provenance
The following attestation bundles were made for newcode-0.1.10.tar.gz:
Publisher:
workflow.yml on janfeddersen-wq/new_code
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
newcode-0.1.10.tar.gz -
Subject digest:
b17c214a6a3ac5f293ceae372c0ca2471f92d1bb401229ea26373566cecf71ca - Sigstore transparency entry: 1004871055
- Sigstore integration time:
-
Permalink:
janfeddersen-wq/new_code@b25932c8d4b050552e66aba306f018a35cf334ee -
Branch / Tag:
refs/heads/main - Owner: https://github.com/janfeddersen-wq
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@b25932c8d4b050552e66aba306f018a35cf334ee -
Trigger Event:
push
-
Statement type:
File details
Details for the file newcode-0.1.10-py3-none-any.whl.
File metadata
- Download URL: newcode-0.1.10-py3-none-any.whl
- Upload date:
- Size: 921.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c0e763f56f74d80104c2823d6c914fcf172547f1968e08a70e8a4171fb25ac1
|
|
| MD5 |
01a167fab6754b94fa4e8b85b2eab80a
|
|
| BLAKE2b-256 |
d9a6ab983a8c04da147fa1a75417b507f91a1dab907869fad4020984ea3dd175
|
Provenance
The following attestation bundles were made for newcode-0.1.10-py3-none-any.whl:
Publisher:
workflow.yml on janfeddersen-wq/new_code
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
newcode-0.1.10-py3-none-any.whl -
Subject digest:
4c0e763f56f74d80104c2823d6c914fcf172547f1968e08a70e8a4171fb25ac1 - Sigstore transparency entry: 1004871061
- Sigstore integration time:
-
Permalink:
janfeddersen-wq/new_code@b25932c8d4b050552e66aba306f018a35cf334ee -
Branch / Tag:
refs/heads/main - Owner: https://github.com/janfeddersen-wq
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
workflow.yml@b25932c8d4b050552e66aba306f018a35cf334ee -
Trigger Event:
push
-
Statement type: