trmsg 1.0.0__tar.gz

trmsg-1.0.0/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+Copyright (c) 2025 trmsg 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.

trmsg-1.0.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: trmsg
+Version: 1.0.0
+Summary: Terminal messaging platform — chat, share files, play games, all from your CLI
+Author: trmsg Contributors
+License: MIT License
+        Copyright (c) 2025 trmsg 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.
+        
+Project-URL: Homepage, https://github.com/yourusername/trmsg
+Project-URL: Repository, https://github.com/yourusername/trmsg
+Keywords: chat,terminal,cli,messaging,websocket,real-time,games,ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.7
+Requires-Dist: rich>=13.7.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: python-jose>=3.3.0
+Requires-Dist: pydantic>=2.6.0
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110.0; extra == "server"
+Requires-Dist: uvicorn[standard]>=0.29.0; extra == "server"
+Requires-Dist: sqlalchemy[asyncio]>=2.0.28; extra == "server"
+Requires-Dist: aiosqlite>=0.20.0; extra == "server"
+Requires-Dist: bcrypt>=4.1.2; extra == "server"
+Requires-Dist: python-multipart>=0.0.9; extra == "server"
+Requires-Dist: pydantic-settings>=2.2.1; extra == "server"
+Requires-Dist: python-jose>=3.3.0; extra == "server"
+Dynamic: license-file
+
+# ⚡ trmsg
+
+**Terminal messaging. Chat. Share files. Play games. All from your CLI.**
+
+```bash
+pip install trmsg
+```
+
+---
+
+## Features
+
+| Feature | Command |
+|---|---|
+| 💬 Real-time chat | `trmsg chat` |
+| 📁 File sharing (200MB) | `/sendfile photo.jpg` |
+| 👥 Friends & DMs | `/add username` |
+| 🤖 AI Assistant (Gemini) | `/ai what is python?` |
+| 💣 Self-destruct messages | `/burn 30 secret message` |
+| 🎮 TicTacToe | `/game ttt opponent` |
+| ♟️ Chess | `/game chess opponent` |
+| 🧠 Quiz Battle | `/game quiz` |
+| 🏆 Leaderboard | `/leaderboard` |
+| 📊 Polls | `/poll "Q?" A \| B \| C` |
+| 😀 Reactions | `/react 5 👍` |
+| ↩️ Reply to messages | `/reply 5 good point!` |
+| 🔔 Keyword alerts | `/alert homework` |
+| 🌙 Do Not Disturb | `/dnd 11pm-7am` |
+| 🎨 Themes | `/theme matrix` |
+| 🔗 Invite links | `/invite create` |
+| 📋 Message search | `/search-msg keyword` |
+| 💻 Code sharing | `/code python print("hi")` |
+| 📣 Announcements | `/announce Important update!` |
+| 👑 Roles | Owner / Admin / VIP / Member |
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install trmsg
+
+# Connect to a server
+trmsg config
+
+# Register
+trmsg register
+
+# Chat!
+trmsg chat
+```
+
+---
+
+## Self-Host Server
+
+```bash
+pip install "trmsg[server]"
+
+# Setup
+echo "SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_hex(32))')" > .env
+echo "DATABASE_URL=sqlite+aiosqlite:///./trmsg.db" >> .env
+echo "GEMINI_API_KEY=your-key-here" >> .env  # optional AI
+mkdir uploads
+
+# Start
+trmsg-server
+```
+
+Friends connect: `trmsg config` → enter your IP → `trmsg register` → `trmsg chat`
+
+---
+
+## AI Commands
+
+```bash
+/ai what is async/await?
+/ai summarize                    # summarize last 50 messages
+/ai translate Japanese hello     # translate text
+/ai explain def foo(): pass      # explain code
+/ai roast janak                  # friendly roast 😈
+```
+
+Powered by **Gemini 1.5 Flash** (free). Add `GEMINI_API_KEY` to server `.env`.
+
+---
+
+## Game Commands
+
+```bash
+/game ttt rohan        # TicTacToe vs rohan
+/game chess priya      # Chess vs priya
+/game quiz             # Quiz battle (room plays together)
+
+/move <id> 5           # TTT: pick cell 1-9
+/move <id> e2e4        # Chess: algebraic notation
+/answer B              # Quiz: answer A/B/C/D
+
+/leaderboard           # Overall rankings
+/leaderboard ttt       # Game-specific rankings
+/mystats               # Your personal stats
+```
+
+---
+
+## All CLI Commands
+
+```bash
+trmsg register       trmsg login         trmsg logout
+trmsg chat           trmsg chat <user>   (DM someone)
+trmsg friends        trmsg users         trmsg rooms
+trmsg add <user>     trmsg whois <user>  trmsg stats
+trmsg leaderboard    trmsg profile       trmsg config
+```
+
+---
+
+## Themes
+
+```bash
+/theme cyberpunk    # neon green (default)
+/theme matrix       # matrix falling code style
+/theme ocean        # cool blue tones
+/theme sunset       # warm red/yellow
+/theme hacker       # deep green hacker
+/theme minimal      # clean white
+```
+
+---
+
+## Deploy to Render (Free)
+
+1. Push to GitHub
+2. Render → New Web Service → connect repo
+3. Build: `pip install ".[server]"`  
+4. Start: `trmsg-server`
+5. Env vars: `SECRET_KEY`, `DATABASE_URL`, `GEMINI_API_KEY`
+
+Share URL → friends install trmsg → connect → chat! 🎉
+
+---
+
+*Built with FastAPI · SQLAlchemy · WebSockets · Rich · Click · Gemini AI*

trmsg-1.0.0/README.md

@@ -0,0 +1,144 @@
+# ⚡ trmsg
+
+**Terminal messaging. Chat. Share files. Play games. All from your CLI.**
+
+```bash
+pip install trmsg
+```
+
+---
+
+## Features
+
+| Feature | Command |
+|---|---|
+| 💬 Real-time chat | `trmsg chat` |
+| 📁 File sharing (200MB) | `/sendfile photo.jpg` |
+| 👥 Friends & DMs | `/add username` |
+| 🤖 AI Assistant (Gemini) | `/ai what is python?` |
+| 💣 Self-destruct messages | `/burn 30 secret message` |
+| 🎮 TicTacToe | `/game ttt opponent` |
+| ♟️ Chess | `/game chess opponent` |
+| 🧠 Quiz Battle | `/game quiz` |
+| 🏆 Leaderboard | `/leaderboard` |
+| 📊 Polls | `/poll "Q?" A \| B \| C` |
+| 😀 Reactions | `/react 5 👍` |
+| ↩️ Reply to messages | `/reply 5 good point!` |
+| 🔔 Keyword alerts | `/alert homework` |
+| 🌙 Do Not Disturb | `/dnd 11pm-7am` |
+| 🎨 Themes | `/theme matrix` |
+| 🔗 Invite links | `/invite create` |
+| 📋 Message search | `/search-msg keyword` |
+| 💻 Code sharing | `/code python print("hi")` |
+| 📣 Announcements | `/announce Important update!` |
+| 👑 Roles | Owner / Admin / VIP / Member |
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install trmsg
+
+# Connect to a server
+trmsg config
+
+# Register
+trmsg register
+
+# Chat!
+trmsg chat
+```
+
+---
+
+## Self-Host Server
+
+```bash
+pip install "trmsg[server]"
+
+# Setup
+echo "SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_hex(32))')" > .env
+echo "DATABASE_URL=sqlite+aiosqlite:///./trmsg.db" >> .env
+echo "GEMINI_API_KEY=your-key-here" >> .env  # optional AI
+mkdir uploads
+
+# Start
+trmsg-server
+```
+
+Friends connect: `trmsg config` → enter your IP → `trmsg register` → `trmsg chat`
+
+---
+
+## AI Commands
+
+```bash
+/ai what is async/await?
+/ai summarize                    # summarize last 50 messages
+/ai translate Japanese hello     # translate text
+/ai explain def foo(): pass      # explain code
+/ai roast janak                  # friendly roast 😈
+```
+
+Powered by **Gemini 1.5 Flash** (free). Add `GEMINI_API_KEY` to server `.env`.
+
+---
+
+## Game Commands
+
+```bash
+/game ttt rohan        # TicTacToe vs rohan
+/game chess priya      # Chess vs priya
+/game quiz             # Quiz battle (room plays together)
+
+/move <id> 5           # TTT: pick cell 1-9
+/move <id> e2e4        # Chess: algebraic notation
+/answer B              # Quiz: answer A/B/C/D
+
+/leaderboard           # Overall rankings
+/leaderboard ttt       # Game-specific rankings
+/mystats               # Your personal stats
+```
+
+---
+
+## All CLI Commands
+
+```bash
+trmsg register       trmsg login         trmsg logout
+trmsg chat           trmsg chat <user>   (DM someone)
+trmsg friends        trmsg users         trmsg rooms
+trmsg add <user>     trmsg whois <user>  trmsg stats
+trmsg leaderboard    trmsg profile       trmsg config
+```
+
+---
+
+## Themes
+
+```bash
+/theme cyberpunk    # neon green (default)
+/theme matrix       # matrix falling code style
+/theme ocean        # cool blue tones
+/theme sunset       # warm red/yellow
+/theme hacker       # deep green hacker
+/theme minimal      # clean white
+```
+
+---
+
+## Deploy to Render (Free)
+
+1. Push to GitHub
+2. Render → New Web Service → connect repo
+3. Build: `pip install ".[server]"`  
+4. Start: `trmsg-server`
+5. Env vars: `SECRET_KEY`, `DATABASE_URL`, `GEMINI_API_KEY`
+
+Share URL → friends install trmsg → connect → chat! 🎉
+
+---
+
+*Built with FastAPI · SQLAlchemy · WebSockets · Rich · Click · Gemini AI*

trmsg-1.0.0/cli/commands/auth.py

@@ -0,0 +1,85 @@
+"""trmsg - Auth Commands"""
+from rich.prompt import Prompt, Confirm
+from rich.panel import Panel
+from cli.config import config
+from cli.network.client import APIClient, APIError
+from cli.ui.theme import print_banner, print_error, print_success, print_info, console
+
+async def register_command():
+    print_banner(config.theme)
+    console.print(Panel.fit("[bold bright_green]Create Account[/bold bright_green]", border_style="bright_green"))
+    api = APIClient()
+    try:
+        username = Prompt.ask("[cyan]Username[/cyan]").strip()
+        password = Prompt.ask("[cyan]Password[/cyan]", password=True)
+        confirm  = Prompt.ask("[cyan]Confirm password[/cyan]", password=True)
+        if password != confirm: print_error("Passwords don't match!"); return
+        if len(password) < 8: print_error("Password must be 8+ characters!"); return
+        email        = Prompt.ask("[cyan]Email[/cyan] [dim](optional)[/dim]", default="").strip() or None
+        display_name = Prompt.ask("[cyan]Display name[/cyan]", default=username).strip()
+        with console.status("[green]Creating account...[/green]"):
+            result = await api.post("/api/v1/users/register", {"username":username,"password":password,"email":email,"display_name":display_name})
+        config.token = result["token"]; config.username = result["username"]; config.avatar_color = result.get("avatar_color","#00ff88")
+        print_success(f"Welcome to trmsg, [bold]{result['username']}[/bold]! ⚡")
+        print_info("Run [bold]trmsg chat[/bold] to start!")
+    except APIError as e: print_error(f"Registration failed: {e.message}")
+    finally: await api.close()
+
+async def login_command():
+    print_banner(config.theme)
+    if config.is_authenticated():
+        print_info(f"Already logged in as [bold]{config.username}[/bold]")
+        if not Confirm.ask("Login as different user?"): return
+    api = APIClient()
+    try:
+        username = Prompt.ask("[cyan]Username[/cyan]").strip()
+        password = Prompt.ask("[cyan]Password[/cyan]", password=True)
+        with console.status("[green]Logging in...[/green]"):
+            result = await api.post("/api/v1/users/login", {"username":username,"password":password})
+        config.token = result["token"]; config.username = result["username"]
+        config.avatar_color = result.get("avatar_color","#00ff88")
+        if result.get("theme"): config.theme = result["theme"]
+        print_success(f"Welcome back, [bold]{result.get('display_name',username)}[/bold]! ⚡")
+        print_info("Run [bold]trmsg chat[/bold] to start!")
+    except APIError as e: print_error(f"Login failed: {e.message}")
+    finally: await api.close()
+
+def logout_command():
+    if not config.is_authenticated(): print_info("Not logged in."); return
+    username = config.username; config.clear_auth()
+    print_success(f"Logged out [bold]{username}[/bold]. Goodbye! 👋")
+
+async def profile_command():
+    api = APIClient()
+    try:
+        me = await api.get("/api/v1/users/me")
+        s = await api.get(f"/api/v1/users/{me['username']}/stats")
+        console.print(f"\n[bold cyan]Your Profile[/bold cyan]")
+        console.print(f"  Username:     [bold]{me['username']}[/bold]")
+        console.print(f"  Display name: {me.get('display_name','—')}")
+        console.print(f"  Bio:          {me.get('bio','—')}")
+        console.print(f"  Status:       {me.get('status','offline')}")
+        console.print(f"  Role:         {me.get('role','member')}")
+        console.print(f"  Score:        🏆 {s.get('score',0)} (Rank #{s.get('rank','?')})")
+        console.print(f"  Messages:     {s.get('total_messages',0)}")
+        console.print(f"  Theme:        {me.get('theme','cyberpunk')}")
+        console.print(f"  Server:       {config.server_url}\n")
+        if Confirm.ask("Edit profile?"):
+            display_name = Prompt.ask("Display name", default=me.get("display_name","")).strip()
+            bio = Prompt.ask("Bio", default=me.get("bio","")).strip()
+            with console.status("[green]Updating...[/green]"):
+                await api.patch("/api/v1/users/me", {"display_name":display_name,"bio":bio})
+            print_success("Profile updated!")
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+def configure_command():
+    console.print("\n[bold cyan]trmsg Configuration[/bold cyan]\n")
+    server = Prompt.ask("[cyan]Server URL[/cyan]", default=config.server_url)
+    config.server_url = server.rstrip("/")
+    from cli.ui.theme import THEMES
+    theme = Prompt.ask("[cyan]Theme[/cyan]", default=config.theme, choices=list(THEMES.keys()))
+    config.theme = theme
+    dl_dir = Prompt.ask("[cyan]Download directory[/cyan]", default=str(config.download_dir))
+    config.download_dir = dl_dir
+    print_success("Configuration saved!")

trmsg-1.0.0/cli/commands/social.py

@@ -0,0 +1,111 @@
+"""trmsg - Social Commands"""
+from rich.table import Table
+from cli.network.client import APIClient, APIError
+from cli.ui.theme import print_error, print_success, print_info, get_status_icon, get_role_badge, format_timestamp, console
+
+async def cmd_add(username):
+    api = APIClient()
+    try:
+        with console.status(f"[green]Sending to {username}...[/green]"):
+            await api.post(f"/api/v1/friends/add/{username}")
+        print_success(f"Friend request sent to [bold]{username}[/bold] 📨")
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_friends():
+    api = APIClient()
+    try:
+        with console.status("[green]Loading...[/green]"): r = await api.get("/api/v1/friends/list")
+        friends = r.get("friends",[])
+        if not friends: print_info("No friends yet. Use [bold]trmsg add <username>[/bold]"); return
+        t = Table(title="👥 Friends",border_style="bright_black",header_style="bold cyan")
+        t.add_column("",width=3); t.add_column("Username",style="bright_cyan"); t.add_column("Display Name"); t.add_column("Status"); t.add_column("Last Seen",style="dim")
+        for f in friends:
+            icon = get_status_icon(f.get("status","offline"))
+            t.add_row(icon, f["username"], f.get("display_name",""), f.get("status_message","") or "", format_timestamp(f.get("last_seen","")) if f.get("last_seen") else "—")
+        console.print(t)
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_users():
+    api = APIClient()
+    try:
+        with console.status("[green]Fetching...[/green]"): r = await api.get("/api/v1/users/online")
+        users = r.get("users",[]); count = r.get("count",0)
+        if not users: print_info("No users online."); return
+        t = Table(title=f"🟢 Online ({count})",border_style="green",header_style="bold green")
+        t.add_column("",width=3); t.add_column("",width=3); t.add_column("Username",style="bright_cyan"); t.add_column("Display Name"); t.add_column("Score",justify="right",style="yellow")
+        for u in users:
+            icon = get_status_icon(u.get("status","online"))
+            badge = get_role_badge(u.get("role","member"))
+            t.add_row(icon, badge, u["username"], u.get("display_name",""), str(u.get("score",0)))
+        console.print(t)
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_leaderboard():
+    api = APIClient()
+    try:
+        with console.status("[green]Loading...[/green]"): r = await api.get("/api/v1/games/leaderboard")
+        t = Table(title="🏆 Leaderboard",border_style="yellow",header_style="bold yellow")
+        t.add_column("Rank",width=5); t.add_column("",width=3); t.add_column("Username",style="bright_cyan"); t.add_column("Score",justify="right",style="bright_yellow"); t.add_column("Status",width=3)
+        medals = ["🥇","🥈","🥉"]
+        for u in r.get("overall",[]):
+            rank = medals[u["rank"]-1] if u["rank"]<=3 else f"#{u['rank']}"
+            status = "[green]●[/green]" if u.get("is_online") else "[dim]○[/dim]"
+            t.add_row(rank, "", u["username"], str(u["score"]), status)
+        console.print(t)
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_stats():
+    api = APIClient()
+    try:
+        with console.status("[green]Fetching...[/green]"): s = await api.get("/api/v1/stats")
+        console.print("\n[bold cyan]── trmsg Server Stats ──[/bold cyan]")
+        console.print(f"  👥 Users:    [bold]{s.get('users',0)}[/bold]")
+        console.print(f"  🟢 Online:   [bold bright_green]{s.get('online_now',0)}[/bold bright_green]")
+        console.print(f"  💬 Rooms:    [bold]{s.get('rooms',0)}[/bold]")
+        console.print(f"  📨 Messages: [bold]{s.get('messages',0)}[/bold]")
+        console.print(f"  📎 Files:    [bold]{s.get('files',0)}[/bold]")
+        console.print(f"  🎮 Games:    [bold]{s.get('games_played',0)}[/bold]\n")
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_whois(username):
+    api = APIClient()
+    try:
+        with console.status(f"[green]Looking up {username}...[/green]"):
+            u = await api.get(f"/api/v1/users/{username}")
+            s = await api.get(f"/api/v1/users/{username}/stats")
+        icon = get_status_icon(u.get("status","offline"))
+        badge = get_role_badge(u.get("role","member"))
+        console.print(f"\n[bold cyan]── {u['username']} {badge} ──[/bold cyan]")
+        console.print(f"  Display:  {u.get('display_name',u['username'])}")
+        console.print(f"  Status:   {icon} {u.get('status','offline')}")
+        if u.get("status_message"): console.print(f"  Message:  {u['status_message']}")
+        if u.get("bio"): console.print(f"  Bio:      {u['bio']}")
+        console.print(f"  Score:    🏆 {s.get('score',0)} (Rank #{s.get('rank','?')})")
+        console.print(f"  Messages: {s.get('total_messages',0)} | Files: {s.get('total_files',0)}")
+        gs = s.get("game_stats",{})
+        if gs:
+            for game, stat in gs.items():
+                console.print(f"  {game.upper()}:   W:{stat['wins']} L:{stat['losses']} Score:{stat['score']}")
+        console.print(f"  Joined:   {u.get('created_at','')[:10]}\n")
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()
+
+async def cmd_rooms():
+    api = APIClient()
+    try:
+        with console.status("[green]Loading...[/green]"): r = await api.get("/api/v1/rooms")
+        rooms = r.get("rooms",[])
+        if not rooms: print_info("No public rooms."); return
+        t = Table(title="📢 Public Rooms",border_style="bright_black",header_style="bold cyan")
+        t.add_column("Icon",width=4); t.add_column("Room",style="bright_cyan"); t.add_column("Category"); t.add_column("Description"); t.add_column("🟢",justify="right"); t.add_column("🔒",width=3)
+        for rm in rooms:
+            t.add_row(rm.get("icon","💬"), f"#{rm['name']}", rm.get("category","") or "", rm.get("description","") or "", str(rm.get("online",0)), "🔒" if rm.get("has_password") else "")
+        console.print(t)
+        console.print("[dim]  Join: trmsg chat → /join <room>[/dim]\n")
+    except APIError as e: print_error(f"Failed: {e.message}")
+    finally: await api.close()

trmsg-1.0.0/cli/config.py

@@ -0,0 +1,83 @@
+"""trmsg - CLI Config"""
+import json
+from pathlib import Path
+from typing import Optional
+
+class CLIConfig:
+    CONFIG_DIR  = Path.home() / ".trmsg"
+    CONFIG_FILE = CONFIG_DIR / "config.json"
+    TOKEN_FILE  = CONFIG_DIR / "token"
+    HISTORY_FILE= CONFIG_DIR / "history"
+
+    def __init__(self):
+        self.CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+        self._data = self._load()
+
+    def _load(self):
+        if self.CONFIG_FILE.exists():
+            try: return json.loads(self.CONFIG_FILE.read_text())
+            except: return {}
+        return {}
+
+    def _save(self):
+        self.CONFIG_FILE.write_text(json.dumps(self._data, indent=2))
+
+    @property
+    def server_url(self): return self._data.get("server_url", "http://localhost:8000")
+    @server_url.setter
+    def server_url(self, v): self._data["server_url"] = v.rstrip("/"); self._save()
+
+    @property
+    def ws_url(self): return self.server_url.replace("http://","ws://").replace("https://","wss://")
+
+    @property
+    def username(self): return self._data.get("username")
+    @username.setter
+    def username(self, v): self._data["username"] = v; self._save()
+
+    @property
+    def avatar_color(self): return self._data.get("avatar_color","#00ff88")
+    @avatar_color.setter
+    def avatar_color(self, v): self._data["avatar_color"] = v; self._save()
+
+    @property
+    def theme(self): return self._data.get("theme","cyberpunk")
+    @theme.setter
+    def theme(self, v): self._data["theme"] = v; self._save()
+
+    @property
+    def token(self):
+        if self.TOKEN_FILE.exists(): return self.TOKEN_FILE.read_text().strip() or None
+        return None
+    @token.setter
+    def token(self, v):
+        if v: self.TOKEN_FILE.write_text(v); self.TOKEN_FILE.chmod(0o600)
+        elif self.TOKEN_FILE.exists(): self.TOKEN_FILE.unlink()
+
+    @property
+    def download_dir(self):
+        p = Path(self._data.get("download_dir", str(Path.home()/"Downloads"/"trmsg")))
+        p.mkdir(parents=True, exist_ok=True)
+        return p
+    @download_dir.setter
+    def download_dir(self, v): self._data["download_dir"] = v; self._save()
+
+    def add_history(self, text: str):
+        if not self.HISTORY_FILE.exists(): h = []
+        else:
+            try: h = json.loads(self.HISTORY_FILE.read_text())
+            except: h = []
+        if text and (not h or h[-1] != text):
+            h.append(text)
+            if len(h) > 200: h = h[-200:]
+            self.HISTORY_FILE.write_text(json.dumps(h))
+
+    def is_authenticated(self): return bool(self.token and self.username)
+
+    def clear_auth(self):
+        self.token = None
+        self._data.pop("username", None)
+        self._data.pop("avatar_color", None)
+        self._save()
+
+config = CLIConfig()