Repository navigation
Releases
v1.1.1 — Prebuilt macOS and Linux packages
This release adds prebuilt Eitri packages for macOS and Linux and moves Homebrew distribution into a dedicated tap. CLI behavior is unchanged from v1.1.0.
- macOS and Linux: native archives for Apple Silicon/ARM64 and Intel/AMD64.
- Windows: x64 and ARM64 ZIP packages, with Scoop metadata updated automatically.
- Homebrew formulas are maintained in veryshyjelly/homebrew-tap and install release binaries without a Go build dependency.
- Documentation is available at https://eitri.veryshyjelly.in/.
Install with Homebrew:
brew install veryshyjelly/tap/eitriIf you used the old tap, uninstall its package and untap it before installing from the new tap:
brew uninstall veryshyjelly/eitri/eitri
brew untap veryshyjelly/eitri
brew install veryshyjelly/tap/eitriWindows / Scoop:
scoop bucket add eitri https://github.com/veryshyjelly/eitri.git
scoop install eitri/eitriExisting Scoop users can run scoop update eitri.
Alternatively, download the archive for your OS and architecture below. The release includes checksums.txt for verifying downloads.
v1.1.0
- Added http endpoint to add test cases
- Added logo in splash screen
- Added homebrew and scoop release publising
Release 1.0.0
feat: Rebranding and doing a stable release.
Release v0.1.5
Feat: added support for submitting code after transpiling.
compiler:
name: Clojurescript
source: main.cljs
compile: build-clj.sh # assuming this compiles and produces a javscript file main.js
args:
- ./main.cljs
run: bun run ./main.js
compiled_file: main.js
This will result in copying and submission of the main.js file resultant of the compilation/transpilatoin process.
Release v0.1.4
Feat: Added strict validation for cocom.yml
Vertical layout support
v0.1.0: Initial Release
🎉 v0.1.0: Initial Release - Meet cocom
I am thrilled to announce the very first release of cocom, a blazing-fast, terminal-native competitive programming companion tool written in Go!
After experimenting with heavy desktop GUI frameworks, I realized that competitive programmers live in the terminal and their code editors. cocom strips away the desktop app overhead and brings problem parsing, intelligent code linking, and sandboxed judging directly to your terminal via a beautiful TUI.
✨ Key Features
🖥️ Beautiful Terminal UI (TUI)
Powered by Bubble Tea and Lipgloss, cocom provides a rich, interactive terminal experience:
- Split-Pane Viewports: Side-by-side views for Input, Output, Expected Answer, and Stderr.
- Zebra-Striping & Mouse Support: Easily readable test cases with full mouse scrolling support.
- Live Status Dots: Visual indicators (🟢 AC, 🔴 WA, ⚪ NA) for all test cases at a glance.
- Vim-like Keybindings: Navigate test cases and panes without ever touching your mouse.
⚡ Instant Problem Parsing
cocom runs a lightweight, built-in HTTP server on 127.0.0.1:6174.
- Simply click the Competitive Companion browser extension on any supported judge (Codeforces, AtCoder, CSES, AOJ, etc.).
cocominstantly parses the problem name, URL, time/memory limits, and sample test cases, injecting them directly into the TUI.
🔗 Intelligent Dependency Linker
Stop manually managing #include, use, or mod statements for your personal CP libraries!
cocomscans your local library directories and builds a dependency graph.- It performs a topological sort to resolve dependencies and detect circular imports.
- Using custom
@code begin/@code endand@head begin/@head endtags, it automatically extracts, deduplicates headers, and merges your library code into a single, clean submission file in the background.
📦 Sandboxed Judging & Execution
- Isolated Environments: Code is compiled and executed in temporary sandbox directories (
os.MkdirTemp), keeping your project root clean. - Strict Limits: Enforces Time Limits (TLE) via context timeouts and kills rogue processes.
- Memory Tracking: Natively tracks peak RSS memory usage on Unix/Linux/macOS systems.
- Auto-Run on Save: Powered by
fsnotify. Just hit save in Neovim/VS Code/Zed, andcocomautomatically recompiles and runs your test cases.
⚙️ Highly Configurable via cocom.yml
Define your entire workflow in a single YAML file per language directory. Configure:
- Regex-based dynamic filename generation based on problem URLs.
- Go
text/templateboilerplate injection (Author, Date, URL, linked libraries). - Custom compiler arguments and run commands for any language (Rust, C++, Python, OCaml, Lean, Gleam, ARM64 Assembly, LLVM IR, and more).
🚀 Getting Started
1. Install cocom
If you have Go installed, you can grab the latest binary instantly:
go install github.com/veryshyjelly/cocom@latest(Or download the pre-compiled binaries for your OS from the assets below).
2. Configure your Browser
Install the Competitive Companion extension for Chrome/Firefox and ensure it is configured to send data to port 27121.
3. Initialize and Run
Navigate to your competitive programming directory and run:
cocomOn first run, if a cocom.yml is missing, cocom will interactively prompt you to generate a starter template for your language of choice!
🙏 Acknowledgments
- Huge thanks to Jmerle for the incredible Competitive Companion extension, which powers the problem-parsing pipeline.
- Built with the amazing Go ecosystem, specifically the Charm TUI libraries.
Happy Coding & Good Luck on your next Contest! 🏆
