moons.py is a small Python CLI for seeing the normal Gregorian calendar and
the 13 Moon calendar at the same time.
It prints the current Gregorian month on the left and the current 13 Moon 28-day grid on the right. Under the 13 Moon grid, it also shows the day's Dreamspell signature: Kin, tone, glyph, and wavespell.
The longer beginner explanation that used to live in this file has moved to FAQ.md.
./moons.pyShow another date:
./moons.py --date 2026-05-31$ ./moons.py --date 2026-05-31
Date: Sunday, May 31, 2026
Gregorian: May 2026 13 Moon: Moon 12, Day 2
+------+------+------+------+------+------+------+ +------+------+------+------+------+------+------+
| Sun | Mon | Tue | Wed | Thu | Fri | Sat | | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
+------+------+------+------+------+------+------+ +------+------+------+------+------+------+------+
| | | | | | 1 | 2 | | 1 | [2] | 3 | 4 | 5 | 6 | 7 |
| 3 | 4 | 5 | 6 | 7 | 8 | 9 | | 8 | 9 | 10 | 11 | 12 | 13 | 14 |
| 10 | 11 | 12 | 13 | 14 | 15 | 16 | | 15 | 16 | 17 | 18 | 19 | 20 | 21 |
| 17 | 18 | 19 | 20 | 21 | 22 | 23 | | 22 | 23 | 24 | 25 | 26 | 27 | 28 |
| 24 | 25 | 26 | 27 | 28 | 29 | 30 | +------+------+------+------+------+------+------+
| [31] | | | | | | |
+------+------+------+------+------+------+------+
+-----------+-----------------------------+------------------------------------------------+
| Field | Value | Meaning |
+-----------+-----------------------------+------------------------------------------------+
| Kin | 173 | Position in the 260-day cycle |
| Signature | Red Self-Existing Skywalker | Define form; create space to explore |
| Tone | 4 Self-Existing | Mode: Define form; make it concrete |
| Glyph | 13 Red Skywalker | Theme: Explore space and cross boundaries |
| Wavespell | Kin 170 White Dog | 13-day arc: Heart, loyalty, love, relationship |
+-----------+-----------------------------+------------------------------------------------+
The left side is the ordinary Gregorian month. In the example, [31] means
May 31 is the selected Gregorian day.
The right side is the 13 Moon calendar. A 13 Moon year has:
13 moons x 28 days = 364 days
The extra day is July 25, called the Day Out of Time. The 13 Moon new year starts on July 26. Because every moon is exactly 28 days, every moon is four clean seven-day weeks.
In the example, the selected date is:
13 Moon: Moon 12, Day 2
That means May 31, 2026 falls on the second day of the twelfth 28-day moon.
The [2] in the right grid marks that moon day.
The panel below the 13 Moon grid gives the symbolic identity of the day.
Think of this as a daily label made from repeating cycles. You do not need to believe anything mystical to use it. At minimum, it is a structured way to ask:
What kind of day am I treating this as?
What theme do I want to notice?
What pattern am I inside?
Kin: 173
Kin is the day number inside the 260-day Dreamspell cycle.
The cycle is built from:
13 tones x 20 glyphs = 260 kin
After Kin 260, the count starts again at Kin 1.
For a novice, read Kin 173 as:
This day is position 173 in the 260-day symbolic cycle.
It is like saying "day 173 of this repeating pattern," not day 173 of the Gregorian year.
Signature: Red Self-Existing Skywalker
The signature is the combined name of the day's tone and glyph.
It follows this shape:
color + tone name + glyph name
For the example:
Red
Self-Existing
Skywalker
This is the main phrase people usually remember for the day.
As a practical daily reflection, you might turn it into a simple prompt:
How can I give structure to exploration today?
That prompt comes from the combination of Self-Existing, which is often read
as form, definition, structure, or measurement, and Skywalker, which is often
read as exploration, space, courage, or stepping beyond a familiar boundary.
You do not have to treat those meanings as fixed truth. Treat them as a lens.
Tone: 4 Self-Existing
The tone is one of 13 repeating numbers.
The tones are:
1 Magnetic
2 Lunar
3 Electric
4 Self-Existing
5 Overtone
6 Rhythmic
7 Resonant
8 Galactic
9 Solar
10 Planetary
11 Spectral
12 Crystal
13 Cosmic
In the example, the tone is 4 Self-Existing.
For daily use, tone 4 is a good cue for:
define the shape
name the problem
make the plan concrete
measure what is real
turn vague intention into form
If you are using this system lightly, the tone can be your "mode" for the day. Tone 4 says: clarify, define, and make the abstract usable.
Glyph: 13 Red Skywalker
The glyph is one of 20 repeating day signs. The number here is the glyph's position in the 20-glyph cycle.
The glyphs are:
1 Red Dragon
2 White Wind
3 Blue Night
4 Yellow Seed
5 Red Serpent
6 White Worldbridger
7 Blue Hand
8 Yellow Star
9 Red Moon
10 White Dog
11 Blue Monkey
12 Yellow Human
13 Red Skywalker
14 White Wizard
15 Blue Eagle
16 Yellow Warrior
17 Red Earth
18 White Mirror
19 Blue Storm
20 Yellow Sun
In the example, the glyph is 13 Red Skywalker.
For daily use, Skywalker can be treated as a prompt about exploration:
Where have I become too cramped?
What boundary can I cross carefully?
What would a wider view reveal?
What space do I need to create?
Again, this is not a prediction. It is a theme to work with.
Wavespell: Kin 170 White Dog
A wavespell is a 13-day sequence. Since there are 13 tones, every wavespell starts at tone 1 and runs through tone 13.
The wavespell is named after the glyph that begins that 13-day sequence.
In the example, the day belongs to the White Dog wavespell, which started at
Kin 170.
For daily use, the wavespell is the larger story arc around the day. If the tone is today's mode and the glyph is today's theme, the wavespell is the 13-day chapter.
White Dog is commonly used as a symbol for heart, loyalty, love, relationship, and devotion. So for this example, you might read the whole panel like this:
This is Kin 173.
The day tone is Self-Existing: define and give form.
The day glyph is Red Skywalker: explore and create space.
The 13-day wavespell is White Dog: keep relationship and heart at the center.
That becomes a practical reflection:
How can I give structure to exploration without losing connection?
Keep using the Gregorian calendar for appointments, bills, deadlines, travel, birthdays, and anything that depends on the outside world.
Use the 13 Moon and Dreamspell information as a second layer. It is best for attention, reflection, rhythm, and planning your own creative life.
A simple daily practice:
- Run
./moons.pyin the morning. - Read the 13 Moon day first:
Moon 12, Day 2. - Read the signature:
Red Self-Existing Skywalker. - Turn the tone into a mode for the day.
- Turn the glyph into a theme for the day.
- Notice the wavespell as the larger 13-day background.
- Write one sentence at the end of the day.
For the sample day, that could look like:
Moon 12, Day 2
Kin 173, Red Self-Existing Skywalker
Today I defined the shape of a project that had felt too vague.
I also noticed where I needed more room to think.
The point is not to escape ordinary time. The point is to stop experiencing time only as obligations and deadlines.
Used well, this CLI gives you a daily rhythm:
Gregorian calendar = what must happen
13 Moon calendar = where am I in the cycle
Tone = how to approach the day
Glyph = what theme to notice
Wavespell = what larger 13-day story I am inside
This program uses these rules:
13 moons per year
28 days per moon
July 25 is Day Out of Time
July 26 starts Moon 1, Day 1
February 29 is treated as 0.0 Hunab Ku, outside the normal kin count
For Dreamspell Kin calculation, the program uses the common Dreamspell anchor:
July 26, 1987 = Kin 34, White Galactic Wizard
From there, the 260-day Kin cycle advances one step per normal day, skipping February 29.