tamaterm 0.1.0__tar.gz

tamaterm-0.1.0/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python -m pytest tests/ -v)",
+      "Bash(python -c \"from tamaterm.cli import cli; cli\\(['--help']\\)\")",
+      "Bash(python -c ' *)",
+      "Bash(python *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git push *)",
+      "Bash(pip install *)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "gemini-vision"
+  ]
+}

tamaterm-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.pytest_cache/
+.ruff_cache/
+*.so
+.venv/
+venv/

tamaterm-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tamaterm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tamaterm-0.1.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: tamaterm
+Version: 0.1.0
+Summary: A virtual pet that lives in your terminal
+Project-URL: Homepage, https://github.com/tamaterm/tamaterm
+Project-URL: Repository, https://github.com/tamaterm/tamaterm
+Project-URL: Issues, https://github.com/tamaterm/tamaterm/issues
+Author: tamaterm contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ascii-art,cli,pet,tamagotchi,terminal,virtual-pet
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: click>=8.0
+Requires-Dist: psutil>=5.9
+Provides-Extra: dev
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# tamaterm
+
+A virtual pet that lives in your terminal.
+
+```
+┌────────────────────────┐
+│ ★ Whiskers [adult]     │
+│    /\_____/\           │
+│   /  *   *  \          │
+│  ( ==  w  == )         │
+│   )    ♪    (          │
+│  (           )         │
+│  hunger  [████████████░░]  85.0 │
+│  happy   [██████████████]  92.0 │
+│  energy  [████████░░░░░░]  55.0 │
+│  clean   [██████████░░░░]  70.0 │
+└────────────────────────┘
+```
+
+## What is this?
+
+tamaterm is a Tamagotchi-style virtual pet that lives in your terminal prompt.
+It reacts to your developer workflow -- git commits make it happy, CPU spikes
+stress it out, and it grows through life stages the longer you care for it.
+
+**It's not a TUI app.** It lives *in* your prompt, above every command you type.
+
+## Install
+
+```bash
+pip install tamaterm
+```
+
+## Quick Start
+
+```bash
+# Create your pet
+tamaterm init Whiskers --type cat
+
+# Install the shell hook (adds pet above your prompt)
+tamaterm install
+
+# Restart your terminal, then care for your pet
+tamaterm feed
+tamaterm play
+tamaterm clean
+```
+
+## How it works
+
+```
+Background daemon (tamaterm daemon)
+├── Monitors: git status, CPU, memory, time
+├── Updates: ~/.tamaterm/pet.json (state)
+└── Writes: ~/.tamaterm/status.txt (display)
+
+Shell hook (in your .bashrc/.zshrc/profile)
+└── cat ~/.tamaterm/status.txt before prompt
+
+CLI (tamaterm feed/play/clean/sleep)
+└── Modifies pet.json, daemon picks up changes
+```
+
+## Features
+
+- **Growth system**: Egg -> Baby -> Teen -> Adult (care-dependent)
+- **Reactive**: Happy when you commit code, stressed during CPU spikes
+- **Stat decay**: Hunger, happiness, energy, hygiene decay over time
+- **Night mode**: Pet sleeps automatically at night
+- **Multi-shell**: Bash, Zsh, PowerShell, Fish
+- **Cross-platform**: Linux, macOS, Windows
+- **Lightweight**: 2 dependencies (click, psutil), ~50KB installed
+
+## Pet Types
+
+| Pet | ASCII | Personality |
+|-----|-------|-------------|
+| Cat | `/\_/\ (o.o)` | Independent, clean |
+| Dog | `/\  /\ (o.o)` | Loyal, energetic |
+| Slime | `(oo)` | Easy to care for |
+
+## Commands
+
+| Command | Effect |
+|---------|--------|
+| `tamaterm init` | Create a new pet |
+| `tamaterm feed` | Feed your pet |
+| `tamaterm play` | Play with your pet |
+| `tamaterm clean` | Clean your pet |
+| `tamaterm sleep` | Put pet to bed |
+| `tamaterm status` | Show detailed stats |
+| `tamaterm doctor` | Diagnose issues |
+| `tamaterm install` | Install shell hook |
+| `tamaterm uninstall` | Remove shell hook |
+| `tamaterm start` | Start daemon |
+| `tamaterm stop` | Stop daemon |
+| `tamaterm revive` | Revive a dead pet |
+
+## How the pet reacts
+
+| Event | Pet reaction |
+|-------|-------------|
+| Git commit | Happiness +8 |
+| New branch | Happiness +5 |
+| CPU > 80% | Energy -5, Happiness -3 |
+| Memory > 90% | Energy -3, Happiness -2 |
+| Night (0-6am) | Auto-sleeps |
+
+## Contributing
+
+Add a new pet! Create a file in `src/tamaterm/art/` with ASCII art for each
+stage and mood. See `art/cat.py` for the pattern.
+
+## License
+
+MIT

tamaterm-0.1.0/README.md

@@ -0,0 +1,116 @@
+# tamaterm
+
+A virtual pet that lives in your terminal.
+
+```
+┌────────────────────────┐
+│ ★ Whiskers [adult]     │
+│    /\_____/\           │
+│   /  *   *  \          │
+│  ( ==  w  == )         │
+│   )    ♪    (          │
+│  (           )         │
+│  hunger  [████████████░░]  85.0 │
+│  happy   [██████████████]  92.0 │
+│  energy  [████████░░░░░░]  55.0 │
+│  clean   [██████████░░░░]  70.0 │
+└────────────────────────┘
+```
+
+## What is this?
+
+tamaterm is a Tamagotchi-style virtual pet that lives in your terminal prompt.
+It reacts to your developer workflow -- git commits make it happy, CPU spikes
+stress it out, and it grows through life stages the longer you care for it.
+
+**It's not a TUI app.** It lives *in* your prompt, above every command you type.
+
+## Install
+
+```bash
+pip install tamaterm
+```
+
+## Quick Start
+
+```bash
+# Create your pet
+tamaterm init Whiskers --type cat
+
+# Install the shell hook (adds pet above your prompt)
+tamaterm install
+
+# Restart your terminal, then care for your pet
+tamaterm feed
+tamaterm play
+tamaterm clean
+```
+
+## How it works
+
+```
+Background daemon (tamaterm daemon)
+├── Monitors: git status, CPU, memory, time
+├── Updates: ~/.tamaterm/pet.json (state)
+└── Writes: ~/.tamaterm/status.txt (display)
+
+Shell hook (in your .bashrc/.zshrc/profile)
+└── cat ~/.tamaterm/status.txt before prompt
+
+CLI (tamaterm feed/play/clean/sleep)
+└── Modifies pet.json, daemon picks up changes
+```
+
+## Features
+
+- **Growth system**: Egg -> Baby -> Teen -> Adult (care-dependent)
+- **Reactive**: Happy when you commit code, stressed during CPU spikes
+- **Stat decay**: Hunger, happiness, energy, hygiene decay over time
+- **Night mode**: Pet sleeps automatically at night
+- **Multi-shell**: Bash, Zsh, PowerShell, Fish
+- **Cross-platform**: Linux, macOS, Windows
+- **Lightweight**: 2 dependencies (click, psutil), ~50KB installed
+
+## Pet Types
+
+| Pet | ASCII | Personality |
+|-----|-------|-------------|
+| Cat | `/\_/\ (o.o)` | Independent, clean |
+| Dog | `/\  /\ (o.o)` | Loyal, energetic |
+| Slime | `(oo)` | Easy to care for |
+
+## Commands
+
+| Command | Effect |
+|---------|--------|
+| `tamaterm init` | Create a new pet |
+| `tamaterm feed` | Feed your pet |
+| `tamaterm play` | Play with your pet |
+| `tamaterm clean` | Clean your pet |
+| `tamaterm sleep` | Put pet to bed |
+| `tamaterm status` | Show detailed stats |
+| `tamaterm doctor` | Diagnose issues |
+| `tamaterm install` | Install shell hook |
+| `tamaterm uninstall` | Remove shell hook |
+| `tamaterm start` | Start daemon |
+| `tamaterm stop` | Stop daemon |
+| `tamaterm revive` | Revive a dead pet |
+
+## How the pet reacts
+
+| Event | Pet reaction |
+|-------|-------------|
+| Git commit | Happiness +8 |
+| New branch | Happiness +5 |
+| CPU > 80% | Energy -5, Happiness -3 |
+| Memory > 90% | Energy -3, Happiness -2 |
+| Night (0-6am) | Auto-sleeps |
+
+## Contributing
+
+Add a new pet! Create a file in `src/tamaterm/art/` with ASCII art for each
+stage and mood. See `art/cat.py` for the pattern.
+
+## License
+
+MIT

tamaterm-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tamaterm"
+version = "0.1.0"
+description = "A virtual pet that lives in your terminal"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "tamaterm contributors" },
+]
+keywords = ["terminal", "pet", "virtual-pet", "cli", "tamagotchi", "ascii-art"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Games/Entertainment",
+]
+dependencies = [
+    "click>=8.0",
+    "psutil>=5.9",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov",
+    "ruff",
+]
+
+[project.scripts]
+tamaterm = "tamaterm.cli:cli"
+
+[project.urls]
+Homepage = "https://github.com/tamaterm/tamaterm"
+Repository = "https://github.com/tamaterm/tamaterm"
+Issues = "https://github.com/tamaterm/tamaterm/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tamaterm"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

tamaterm-0.1.0/src/tamaterm/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

tamaterm-0.1.0/src/tamaterm/art/cat.py

@@ -0,0 +1,273 @@
+from ..art_registry import register_art, register_art_default
+from ..constants import PetType, Stage, Mood
+
+
+@register_art_default(PetType.CAT, Stage.EGG)
+def cat_egg():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   o   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.EGG, Mood.HAPPY)
+def cat_egg_happy():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   *   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.EGG, Mood.HUNGRY)
+def cat_egg_hungry():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   ~   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.EGG, Mood.SLEEPING)
+def cat_egg_sleeping():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   -   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+        "   z Z z     ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.EGG, Mood.SAD)
+def cat_egg_sad():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   .   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.EGG, Mood.DEAD)
+def cat_egg_dead():
+    return [
+        "    .---.    ",
+        "   /     \\   ",
+        "  |   x   |  ",
+        "  |       |  ",
+        "   '-----'   ",
+        "     RIP     ",
+    ]
+
+
+@register_art_default(PetType.CAT, Stage.BABY)
+def cat_baby():
+    return [
+        "  /\\_/\\  ",
+        " ( o.o ) ",
+        "  > ^ <  ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.BABY, Mood.HAPPY)
+def cat_baby_happy():
+    return [
+        "  /\\_/\\  ",
+        " ( ^.^ ) ",
+        "  > ^ <  ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.BABY, Mood.HUNGRY)
+def cat_baby_hungry():
+    return [
+        "  /\\_/\\  ",
+        " ( o.o ) ",
+        "  > ~ <  ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.BABY, Mood.SLEEPING)
+def cat_baby_sleeping():
+    return [
+        "  /\\_/\\  ",
+        " ( -.- ) ",
+        "  > ^ <  ",
+        "  z Z z  ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.BABY, Mood.SAD)
+def cat_baby_sad():
+    return [
+        "  /\\_/\\  ",
+        " ( ._. ) ",
+        "  > ^ <  ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.BABY, Mood.DEAD)
+def cat_baby_dead():
+    return [
+        "  /\\_/\\  ",
+        " ( x.x ) ",
+        "  > ^ <  ",
+        "   RIP   ",
+    ]
+
+
+@register_art_default(PetType.CAT, Stage.TEEN)
+def cat_teen():
+    return [
+        "   /\\_/\\   ",
+        "  ( o.o )  ",
+        "   > ^ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.TEEN, Mood.HAPPY)
+def cat_teen_happy():
+    return [
+        "   /\\_/\\   ",
+        "  ( ^.^ )  ",
+        "   > ^ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.TEEN, Mood.SLEEPING)
+def cat_teen_sleeping():
+    return [
+        "   /\\_/\\   ",
+        "  ( -.- )  ",
+        "   > ^ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+        "   z Z z   ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.TEEN, Mood.DEAD)
+def cat_teen_dead():
+    return [
+        "   /\\_/\\   ",
+        "  ( x.x )  ",
+        "   > ^ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+        "    RIP    ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.TEEN, Mood.HUNGRY)
+def cat_teen_hungry():
+    return [
+        "   /\\_/\\   ",
+        "  ( o.o )  ",
+        "   > ~ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.TEEN, Mood.SAD)
+def cat_teen_sad():
+    return [
+        "   /\\_/\\   ",
+        "  ( ._. )  ",
+        "   > ^ <   ",
+        "  /|   |\\  ",
+        " (_|   |_) ",
+    ]
+
+
+@register_art_default(PetType.CAT, Stage.ADULT)
+def cat_adult():
+    return [
+        "    /\\_____/\\    ",
+        "   /  o   o  \\   ",
+        "  ( ==  ^  == )  ",
+        "   )         (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+    ]
+
+
+@register_art(PetType.CAT, Stage.ADULT, Mood.HAPPY)
+def cat_adult_happy():
+    return [
+        "    /\\_____/\\    ",
+        "   /  *   *  \\   ",
+        "  ( ==  w  == )  ",
+        "   )    ~    (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+    ]
+
+
+@register_art(PetType.CAT, Stage.ADULT, Mood.SLEEPING)
+def cat_adult_sleeping():
+    return [
+        "    /\\_____/\\    ",
+        "   /  -   -  \\   ",
+        "  ( ==  w  == )  ",
+        "   )  z Z    (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+    ]
+
+
+@register_art(PetType.CAT, Stage.ADULT, Mood.HUNGRY)
+def cat_adult_hungry():
+    return [
+        "    /\\_____/\\    ",
+        "   /  o   o  \\   ",
+        "  ( ==  ~  == )  ",
+        "   )         (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+    ]
+
+
+@register_art(PetType.CAT, Stage.ADULT, Mood.DEAD)
+def cat_adult_dead():
+    return [
+        "    /\\_____/\\    ",
+        "   /  x   x  \\   ",
+        "  ( ==  -  == )  ",
+        "   )         (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+        "      RIP        ",
+    ]
+
+
+@register_art(PetType.CAT, Stage.ADULT, Mood.SAD)
+def cat_adult_sad():
+    return [
+        "    /\\_____/\\    ",
+        "   /  .   .  \\   ",
+        "  ( ==  v  == )  ",
+        "   )         (   ",
+        "  (           )  ",
+        " ( (  )   (  ) ) ",
+        "(__|__|___|__|__)",
+    ]