pi-everforest 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.md +151 -0
- package/assets/preview.svg +73 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.1.4] - 2026-08-21
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Project README with installation, configuration, theme reference, and palette preview.
|
|
15
|
+
|
|
16
|
+
## [0.1.3] - 2026-08-12
|
|
17
|
+
|
|
18
|
+
### Fixed
|
|
19
|
+
|
|
20
|
+
- Point `homepage` in `package.json` at the pi.dev package page.
|
|
21
|
+
|
|
10
22
|
## [0.1.2] - 2026-08-12
|
|
11
23
|
|
|
12
24
|
## [0.1.1] - 2026-08-11
|
package/README.md
ADDED
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
# Pi Everforest
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/pi-everforest)
|
|
4
|
+
[](https://pi.dev/packages/pi-everforest)
|
|
5
|
+
[](./LICENSE)
|
|
6
|
+
|
|
7
|
+
Six warm, green-based [Everforest](https://github.com/sainnhe/everforest) color schemes packaged as installable themes for the [Pi coding agent](https://pi.dev).
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<img src="assets/preview.svg" alt="Everforest dark medium and light medium palette previews" width="100%">
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
> The preview illustrates the package palettes. Exact colors depend on your terminal and display settings.
|
|
14
|
+
|
|
15
|
+
## Features
|
|
16
|
+
|
|
17
|
+
- Dark and light variants with hard, medium, and soft contrast levels
|
|
18
|
+
- Colors for Pi's UI, Markdown, diffs, syntax highlighting, thinking levels, and bash mode
|
|
19
|
+
- Matching colors for Pi HTML exports
|
|
20
|
+
- Native Pi package discovery through `pi.themes`
|
|
21
|
+
- No runtime dependencies
|
|
22
|
+
|
|
23
|
+
## Install
|
|
24
|
+
|
|
25
|
+
Install the package from npm:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
pi install npm:pi-everforest
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Or install it directly from GitHub:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
pi install git:github.com/angribot/pi-everforest
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
To install the package only for the current project, add `-l`:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
pi install -l npm:pi-everforest
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Themes
|
|
44
|
+
|
|
45
|
+
| Theme | Variant | Contrast |
|
|
46
|
+
| --- | --- | --- |
|
|
47
|
+
| `everforest-dark-hard` | Dark | Hard |
|
|
48
|
+
| `everforest-dark-medium` | Dark | Medium |
|
|
49
|
+
| `everforest-dark-soft` | Dark | Soft |
|
|
50
|
+
| `everforest-light-hard` | Light | Hard |
|
|
51
|
+
| `everforest-light-medium` | Light | Medium |
|
|
52
|
+
| `everforest-light-soft` | Light | Soft |
|
|
53
|
+
|
|
54
|
+
`medium` is Everforest's default contrast level and a good place to start.
|
|
55
|
+
|
|
56
|
+
## Use
|
|
57
|
+
|
|
58
|
+
### Select interactively
|
|
59
|
+
|
|
60
|
+
Open `/settings` in Pi and select one of the six theme names above.
|
|
61
|
+
|
|
62
|
+
### Configure a theme
|
|
63
|
+
|
|
64
|
+
Set the `theme` key in `~/.pi/agent/settings.json`:
|
|
65
|
+
|
|
66
|
+
```json
|
|
67
|
+
{
|
|
68
|
+
"theme": "everforest-dark-medium"
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Follow terminal appearance
|
|
73
|
+
|
|
74
|
+
Pair a light theme with a dark theme to follow your terminal's appearance:
|
|
75
|
+
|
|
76
|
+
```json
|
|
77
|
+
{
|
|
78
|
+
"theme": "everforest-light-medium/everforest-dark-medium"
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
The light theme goes before the slash and the dark theme after it. The same pattern works with the hard and soft pairs.
|
|
83
|
+
|
|
84
|
+
### Use for one session
|
|
85
|
+
|
|
86
|
+
Start Pi with a theme without changing the saved setting:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
pi --use-theme everforest-dark-medium
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Or use the automatic light/dark pair:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
pi --use-theme everforest-light-medium/everforest-dark-medium
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Palette design
|
|
99
|
+
|
|
100
|
+
[Everforest](https://github.com/sainnhe/everforest) describes its palette as green-based, warm-toned, and designed around soft contrast. This package maps its two variants and three contrast levels onto Pi's theme tokens:
|
|
101
|
+
|
|
102
|
+
- core UI and message surfaces
|
|
103
|
+
- success, warning, and error states
|
|
104
|
+
- Markdown and code syntax
|
|
105
|
+
- tool output and diffs
|
|
106
|
+
- thinking-level and bash-mode borders
|
|
107
|
+
- HTML export surfaces
|
|
108
|
+
|
|
109
|
+
This is an independent Pi theme package based on the upstream Everforest palette; it is not an official Everforest project.
|
|
110
|
+
|
|
111
|
+
## Terminal notes
|
|
112
|
+
|
|
113
|
+
Pi uses 24-bit RGB colors. Most modern terminals support them, while older 256-color terminals receive an approximation.
|
|
114
|
+
|
|
115
|
+
You can check for true-color support with:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
echo "$COLORTERM"
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
The result is commonly `truecolor` or `24bit`. In VS Code, set `terminal.integrated.minimumContrastRatio` to `1` if its automatic contrast adjustment changes the palette.
|
|
122
|
+
|
|
123
|
+
## Development
|
|
124
|
+
|
|
125
|
+
Load a theme directly from a checkout:
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
pi \
|
|
129
|
+
--theme ./themes/everforest-dark-medium.json \
|
|
130
|
+
--use-theme everforest-dark-medium
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Validate all theme files as JSON:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
for theme in themes/*.json; do
|
|
137
|
+
python3 -m json.tool "$theme" >/dev/null || exit 1
|
|
138
|
+
done
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Theme files include Pi's JSON schema URL for editor completion and validation.
|
|
142
|
+
|
|
143
|
+
## Credits
|
|
144
|
+
|
|
145
|
+
- Palette: [sainnhe/everforest](https://github.com/sainnhe/everforest)
|
|
146
|
+
- Pi theme documentation: [Themes](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/themes.md)
|
|
147
|
+
- Pi package documentation: [Packages](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/packages.md)
|
|
148
|
+
|
|
149
|
+
## License
|
|
150
|
+
|
|
151
|
+
[MIT](LICENSE). Everforest is also distributed under the MIT License by its upstream authors.
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="560" viewBox="0 0 1200 560" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">Pi Everforest palette preview</title>
|
|
3
|
+
<desc id="desc">Side-by-side previews of the Everforest dark medium and light medium themes for pi.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<filter id="shadow" x="-10%" y="-10%" width="120%" height="130%">
|
|
6
|
+
<feDropShadow dx="0" dy="12" stdDeviation="16" flood-color="#1E2326" flood-opacity="0.28"/>
|
|
7
|
+
</filter>
|
|
8
|
+
</defs>
|
|
9
|
+
|
|
10
|
+
<rect width="1200" height="560" rx="28" fill="#E6E2CC"/>
|
|
11
|
+
|
|
12
|
+
<g transform="translate(54 54)" filter="url(#shadow)">
|
|
13
|
+
<rect width="522" height="452" rx="18" fill="#2D353B"/>
|
|
14
|
+
<path d="M18 0h486a18 18 0 0 1 18 18v42H0V18A18 18 0 0 1 18 0Z" fill="#343F44"/>
|
|
15
|
+
<circle cx="28" cy="30" r="7" fill="#E67E80"/>
|
|
16
|
+
<circle cx="52" cy="30" r="7" fill="#DBBC7F"/>
|
|
17
|
+
<circle cx="76" cy="30" r="7" fill="#A7C080"/>
|
|
18
|
+
<text x="261" y="36" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" font-weight="600" fill="#9DA9A0">everforest-dark-medium</text>
|
|
19
|
+
|
|
20
|
+
<text x="30" y="105" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="18" font-weight="700" fill="#E69875">Pi Everforest</text>
|
|
21
|
+
<text x="30" y="137" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#D3C6AA">Warm, green-based colors for focused coding.</text>
|
|
22
|
+
|
|
23
|
+
<rect x="24" y="168" width="474" height="88" rx="10" fill="#343F44"/>
|
|
24
|
+
<text x="42" y="198" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="13" font-weight="700" fill="#83C092">YOU</text>
|
|
25
|
+
<text x="42" y="227" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#D3C6AA">Add a calm color scheme to pi.</text>
|
|
26
|
+
|
|
27
|
+
<text x="30" y="294" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="13" font-weight="700" fill="#E69875">READ</text>
|
|
28
|
+
<text x="82" y="294" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="14" fill="#859289">themes/everforest-dark-medium.json</text>
|
|
29
|
+
<rect x="24" y="314" width="474" height="66" rx="10" fill="#425047"/>
|
|
30
|
+
<text x="42" y="354" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#A7C080">✓ Theme loaded successfully</text>
|
|
31
|
+
|
|
32
|
+
<g transform="translate(30 407)">
|
|
33
|
+
<rect width="46" height="18" rx="9" fill="#E67E80"/>
|
|
34
|
+
<rect x="56" width="46" height="18" rx="9" fill="#E69875"/>
|
|
35
|
+
<rect x="112" width="46" height="18" rx="9" fill="#DBBC7F"/>
|
|
36
|
+
<rect x="168" width="46" height="18" rx="9" fill="#A7C080"/>
|
|
37
|
+
<rect x="224" width="46" height="18" rx="9" fill="#83C092"/>
|
|
38
|
+
<rect x="280" width="46" height="18" rx="9" fill="#7FBBB3"/>
|
|
39
|
+
<rect x="336" width="46" height="18" rx="9" fill="#D699B6"/>
|
|
40
|
+
</g>
|
|
41
|
+
</g>
|
|
42
|
+
|
|
43
|
+
<g transform="translate(624 54)" filter="url(#shadow)">
|
|
44
|
+
<rect width="522" height="452" rx="18" fill="#FDF6E3"/>
|
|
45
|
+
<path d="M18 0h486a18 18 0 0 1 18 18v42H0V18A18 18 0 0 1 18 0Z" fill="#F4F0D9"/>
|
|
46
|
+
<circle cx="28" cy="30" r="7" fill="#F85552"/>
|
|
47
|
+
<circle cx="52" cy="30" r="7" fill="#DFA000"/>
|
|
48
|
+
<circle cx="76" cy="30" r="7" fill="#8DA101"/>
|
|
49
|
+
<text x="261" y="36" text-anchor="middle" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" font-weight="600" fill="#829181">everforest-light-medium</text>
|
|
50
|
+
|
|
51
|
+
<text x="30" y="105" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="18" font-weight="700" fill="#F57D26">Pi Everforest</text>
|
|
52
|
+
<text x="30" y="137" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#5C6A72">Warm, green-based colors for focused coding.</text>
|
|
53
|
+
|
|
54
|
+
<rect x="24" y="168" width="474" height="88" rx="10" fill="#F4F0D9"/>
|
|
55
|
+
<text x="42" y="198" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="13" font-weight="700" fill="#35A77C">YOU</text>
|
|
56
|
+
<text x="42" y="227" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#5C6A72">Add a calm color scheme to pi.</text>
|
|
57
|
+
|
|
58
|
+
<text x="30" y="294" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="13" font-weight="700" fill="#F57D26">READ</text>
|
|
59
|
+
<text x="82" y="294" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="14" fill="#939F91">themes/everforest-light-medium.json</text>
|
|
60
|
+
<rect x="24" y="314" width="474" height="66" rx="10" fill="#F0F1D2"/>
|
|
61
|
+
<text x="42" y="354" font-family="ui-monospace, SFMono-Regular, Menlo, monospace" font-size="15" fill="#8DA101">✓ Theme loaded successfully</text>
|
|
62
|
+
|
|
63
|
+
<g transform="translate(30 407)">
|
|
64
|
+
<rect width="46" height="18" rx="9" fill="#F85552"/>
|
|
65
|
+
<rect x="56" width="46" height="18" rx="9" fill="#F57D26"/>
|
|
66
|
+
<rect x="112" width="46" height="18" rx="9" fill="#DFA000"/>
|
|
67
|
+
<rect x="168" width="46" height="18" rx="9" fill="#8DA101"/>
|
|
68
|
+
<rect x="224" width="46" height="18" rx="9" fill="#35A77C"/>
|
|
69
|
+
<rect x="280" width="46" height="18" rx="9" fill="#3A94C5"/>
|
|
70
|
+
<rect x="336" width="46" height="18" rx="9" fill="#DF69BA"/>
|
|
71
|
+
</g>
|
|
72
|
+
</g>
|
|
73
|
+
</svg>
|
package/package.json
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-everforest",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Everforest color schemes (dark/light × hard/medium/soft) as themes for the pi coding agent",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
8
|
"url": "git+https://github.com/angribot/pi-everforest.git"
|
|
9
9
|
},
|
|
10
|
-
"homepage": "https://
|
|
10
|
+
"homepage": "https://pi.dev/packages/pi-everforest",
|
|
11
11
|
"bugs": {
|
|
12
12
|
"url": "https://github.com/angribot/pi-everforest/issues"
|
|
13
13
|
},
|