https://github.com/fielding/human-plus-plus
A Base24 color scheme and lightweight annotation convention for the post-artisanal coding era.
https://github.com/fielding/human-plus-plus
base24 color-palette color-scheme colors colorscheme customization dark-theme nixers theme
Last synced: 4 months ago
JSON representation
A Base24 color scheme and lightweight annotation convention for the post-artisanal coding era.
- Host: GitHub
- URL: https://github.com/fielding/human-plus-plus
- Owner: fielding
- Created: 2026-01-22T01:13:24.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-28T20:15:24.000Z (5 months ago)
- Last Synced: 2026-01-29T00:24:11.845Z (5 months ago)
- Topics: base24, color-palette, color-scheme, colors, colorscheme, customization, dark-theme, nixers, theme
- Language: Python
- Homepage: https://fielding.github.io/human-plus-plus/
- Size: 208 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
A Base24 color scheme for the post-artisanal coding era.
Website •
Install •
Palette •
Markers
---
As models write more code, humans spend more time reviewing, planning, and explaining intent. Human++ makes human judgment visible at a glance through a two-tier accent system and lightweight annotation markers.
## Philosophy
Human++ inverts the traditional syntax highlighting priority:
- **Quiet syntax** — everyday code fades into the background
- **Loud diagnostics** — errors, warnings, and human markers demand attention
- **Terminal exception** — terminal output is intentional, so terminals get loud colors
The result: when you see color, it means something.
## The Palette
Human++ uses a cool charcoal grayscale with warm cream text and a full Base24 palette:
- **base00–07** — Cool grayscale from charcoal to warm cream
- **base08–0F** — Loud accents for diagnostics and signals
- **base10–17** — Quiet accents for syntax and UI
Full palette reference
### Grayscale
| Slot | Hex | Role |
|------|-----|------|
| base00 | `#1a1c22` | Background |
| base01 | `#282b31` | Elevation |
| base02 | `#3a3d42` | Selection |
| base03 | `#5a5d62` | Comments |
| base04 | `#828079` | UI secondary |
| base05 | `#dbd6cc` | Main text |
| base06 | `#eeeae2` | Emphasis |
| base07 | `#f8f6f2` | Brightest |
### Loud Accents (Diagnostics & Signals)
| Slot | Hex | Role |
|------|-----|------|
| base08 | `#e7349c` | Errors, attention |
| base09 | `#f26c33` | Warnings |
| base0A | `#f2a633` | Caution |
| base0B | `#04b372` | Success |
| base0C | `#1ad0d6` | Info |
| base0D | `#458ae2` | Links, focus |
| base0E | `#9871fe` | Special |
| base0F | `#bbff00` | Human intent marker |
### Quiet Accents (Syntax & UI)
| Slot | Hex | Role |
|------|-----|------|
| base10 | `#c8518f` | Keywords |
| base11 | `#d68c6f` | Decorators |
| base12 | `#dfb683` | Constants |
| base13 | `#61b186` | CSS classes |
| base14 | `#91cbcd` | Types |
| base15 | `#5e84b6` | Functions |
| base16 | `#8f72e3` | Parameters |
| base17 | `#d2fc91` | Strings |
## Human Intent Markers
Use punctuation markers in comments to flag human judgment:
| Marker | Aliases | Meaning | Color |
|--------|---------|---------|-------|
| `!!` | FIXME, BUG, XXX | Pay attention here | Lime (base0F) |
| `??` | TODO, HACK | I'm uncertain | Purple (base0E) |
| `>>` | NOTE, NB | See reference | Cyan (base0C) |
```js
// Regular comment stays calm (base03)
// !! Critical: don't change without talking to Sarah
if (legacyMode) {
// TODO: Not sure this handles the edge case
return transformLegacy(data);
}
// NOTE: See utils.ts for the transform logic
return transform(data);
```
### Why punctuation?
- Fast to type
- Easy to scan
- Easy to grep: `rg "// !!|// \?\?|// >>"`
- Easy for editors to highlight
- Legacy keywords (TODO, FIXME, NOTE) also work
## Install
### VS Code / Cursor (Recommended)
The VS Code extension includes the full theme plus **marker highlighting** and **inline diagnostics**:
```bash
# Build and install from source
cd packages/vscode-extension
npm install && npx @vscode/vsce package
code --install-extension human-plus-plus-1.0.0.vsix
```
Or download `human-plus-plus-*.vsix` from [Releases](https://github.com/fielding/human-plus-plus/releases).
**Features:**
- Color theme with quiet syntax + loud diagnostics
- Marker highlighting (`!!`, `??`, `>>`) with colored backgrounds
- Inline diagnostic badges for errors/warnings
### Other Apps
All theme files are generated from `palette.toml`:
```bash
git clone https://github.com/fielding/human-plus-plus
cd human-plus-plus
make build # Generate all themes
make apply # Apply to installed apps
```
| App | Location |
|-----|----------|
| Ghostty | `dist/ghostty/config` |
| Vim / Neovim | via tinty |
| Sketchybar | `dist/sketchybar/colors.sh` |
| JankyBorders | `dist/borders/bordersrc` |
| skhd | `dist/skhd/modes.sh` |
### With tinty
```bash
tinty apply base24-human-plus-plus
```
## Development
```bash
make build # Build all theme files
make preview # Preview palette in terminal
make colortest # Display terminal ANSI mapping
make apply-dry # Preview what apply would do
make analyze # Analyze palette in OKLCH
```
### Repository Structure
```
palette.toml # Single source of truth (edit this)
templates/ # Theme templates
tools/ # Python generators
scripts/ # Shell orchestration
site/assets/ # Logos and images
```
**Generated (gitignored):**
```
dist/ # Theme outputs
site/data/ # Palette JSON
```
## License
MIT