Skip to main content

AI-powered code generation agent - a fedstew fork of code-puppy

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/code_puppy/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.7.tar.gz (710.0 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.7-py3-none-any.whl (924.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: newcode-0.1.7.tar.gz
  • Upload date:
  • Size: 710.0 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.7.tar.gz
Algorithm Hash digest
SHA256 4ee62551e0c946d18dfbbbe97ece6d92e292d497d45a05967799bfef251f8aa6
MD5 ff12ae8a92fec331e7ed8715f680f32b
BLAKE2b-256 908d54b9727f2ae229b1f7670e9b8e32783492ef872128f9d378490753223f45

See more details on using hashes here.

Provenance

The following attestation bundles were made for newcode-0.1.7.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.7-py3-none-any.whl.

File metadata

  • Download URL: newcode-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 924.7 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 dc39059c981e65ba95f1456beb69c6bcb58cb5684747418d6a39ae0064463db2
MD5 adba32f2506f7fd21e59761a84152f4c
BLAKE2b-256 3677ac005f30b013775297831340f6207d1942b2dae5a4534fa91637a3ecb623

See more details on using hashes here.

Provenance

The following attestation bundles were made for newcode-0.1.7-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