Barrett Ruth ff5ba39a59 docs: fix dependencies section in readme

Problem: time and timeout were listed as optional dependencies despite
being required for plugin initialization. nix was not mentioned as an
alternative to uv for the Python scraping environment.

Solution: rename section to "Dependencies", list time/timeout first,
and add nix as an alternative to uv for scraping.

2026-02-21 23:59:40 -05:00

2.5 KiB

Raw Permalink Blame History

cp.nvim

The definitive competitive programming environment for Neovim

Scrape problems, run tests, and debug solutions across multiple platforms with zero configuration.

https://github.com/user-attachments/assets/e81d8dfb-578f-4a79-9989-210164fc0148

Features

Multi-platform support: AtCoder, CodeChef, Codeforces, and CSES
Automatic problem setup: Scrape test cases and metadata in seconds
Dual view modes: Lightweight I/O view for quick feedback, full panel for detailed analysis
Test case management: Quickly view, edit, add, & remove test cases
Rich test output: 256 color ANSI support for compiler errors and program output
Language agnostic: Works with any language
Diff viewer: Compare expected vs actual output with 3 diff modes

Installation

Install using your package manager of choice or via luarocks:

luarocks install cp.nvim

Dependencies

GNU time and timeout
uv or nix for problem scraping

Quick Start

cp.nvim follows a simple principle: solve locally, submit remotely.

Basic Usage

Find a contest or problem
Set up contests locally
```
:CP codeforces 1848
```
Code and test
```
:CP run
```
Navigate between problems
```
:CP next
:CP prev
:CP e1
```
Debug and edit test cases

:CP edit
:CP panel --debug

Submit on the original website

Documentation

:help cp.nvim

See my config for the setup in the video shown above.

Motivation

I could not find a neovim-centric, efficient, dependency-free, flexible, and easily customizable competitive programming workflow that "just works"--so I made it myself. I conferenced with top competitive programmers at Carnegie Mellon Univerity and the University of Virginia and covered their (and my) pain points:

Scraping: contests are automatically loaded asynchronously
Test Case Management: test case editor (:CP edit)
UI: both run and panel layouts cover common formats
Extensibility: snippet plugins, compilation, etc. are left to the programmer

2.5 KiB Raw Permalink Blame History