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, 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 utilities
  • Plugin/callback extensibility hooks

Quick start

1) Install

pip install newcode

Or with uv:

uv pip install newcode

2) Launch

newcode

Short alias:

nc

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

3) First useful commands

/config         # Show current configuration
/model          # Select or switch model
/agent          # Select or switch agent
/colors         # Customize terminal UI colors

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

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

Testing

Run the test suite:

uv run pytest tests/ -v

Run linting and formatting checks:

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.

Project links

Data verified by PyPI on Apr 23, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JanFeddersen from gravatar.com JanFeddersen

Credits

Author: Jan Feddersen, Michael Pfaffenberger (original code-puppy author)

GitHub Statistics

Data verified by PyPI on Apr 23, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python <3.14, >=3.11

Classifiers

Report project as malware

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.3.2.tar.gz (624.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.3.2-py3-none-any.whl (776.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for newcode-0.3.2.tar.gz
Algorithm Hash digest
SHA256 2d49a73f1496d493aab285f510a9e16807ffa1e38d2ce9a41a02d5e66ede1d6b
MD5 e3e30f73c6df6025187ae3e378bab090
BLAKE2b-256 d80defaccb69efd59724009a6c8164eb74aa11b9c245e8279a0a831ae4a4c606

See more details on using hashes here.

Provenance

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

File metadata

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

File hashes

Hashes for newcode-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c86392c737bf321039bc9bbc3310bac1851a694b62941dd032f1d2a36c7998ae
MD5 69adaf2e78ab5b1c6c2bec1e4094ae3c
BLAKE2b-256 c6b44d8aee8efb14e7779a9481d691d976ddd3958a69751c5690d4bf30b2be47

See more details on using hashes here.

Provenance

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

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 files

0.3.1

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Supported by

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