Skip to main content

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 newcode instead of code-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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

newcode-0.1.9.tar.gz (709.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

newcode-0.1.9-py3-none-any.whl (921.9 kB view details)

Uploaded Python 3

File details

Details for the file newcode-0.1.9.tar.gz.

File metadata

  • Download URL: newcode-0.1.9.tar.gz
  • Upload date:
  • Size: 709.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for newcode-0.1.9.tar.gz
Algorithm Hash digest
SHA256 6e6173dadd810a092e4a430a3fc5634b69d161dccbff2ab98924473c63cf5d9c
MD5 0a2176cc99c0f88c28b68ec76166ec2c
BLAKE2b-256 74eededb9569d2c4d4a1e10a7372f27213f8710b68a08da5f35e8dd27b627453

See more details on using hashes here.

Provenance

The following attestation bundles were made for newcode-0.1.9.tar.gz:

Publisher: workflow.yml on janfeddersen-wq/new_code

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file newcode-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: newcode-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 921.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for newcode-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 12e7ede9c72e411a788e95a694581925770bb8157474fd44af542629fb48fa48
MD5 0d3503bfe7b30fd3a4b0c3ec6ccdfbcf
BLAKE2b-256 281dc6160289c18d294f353db91498e0fbcb4790001dfd63ec92b76e325f463d

See more details on using hashes here.

Provenance

The following attestation bundles were made for newcode-0.1.9-py3-none-any.whl:

Publisher: workflow.yml on janfeddersen-wq/new_code

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page