portacode 0.2.6.dev0__tar.gz → 0.3.dev20__tar.gz

portacode-0.3.dev20/.claude/agents/communication-manager.md

@@ -0,0 +1,5 @@
+---
+name: communication-manager
+description: Expert code protocol engineer. Accurately defines and improves simple yet straightforward and concise scallable communication protocols for websocket communication between devices and user sessions
+tools: Read, Grep, Glob
+---

portacode-0.3.dev20/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:stackoverflow.com)",
+      "Bash(docker-compose logs:*)",
+      "Bash(python:*)",
+      "Bash(find:*)",
+      "Bash(touch:*)",
+      "Bash(npm run lint)",
+      "Bash(node:*)"
+    ],
+    "deny": []
+  }
+}

portacode-0.3.dev20/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.egg-info
+*.env
+dist
+.pypirc
+_version.py
+client_sessions.json
+project_state_debug.json

portacode-0.3.dev20/LICENSE

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

portacode-0.3.dev20/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.1
+Name: portacode
+Version: 0.3.dev20
+Summary: Portacode CLI client and SDK
+Home-page: https://github.com/portacode/portacode
+Author: Meena Erian
+Author-email: hi@menas.pro
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: platformdirs>=3.0
+Requires-Dist: cryptography>=41.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: pyperclip>=1.8
+Requires-Dist: psutil>=5.9
+Requires-Dist: pyte>=0.8
+Requires-Dist: pywinpty>=2.0; platform_system == "Windows"
+Requires-Dist: GitPython>=3.1.45
+Requires-Dist: watchdog>=3.0
+Requires-Dist: diff-match-patch>=20230430
+Requires-Dist: Pygments>=2.14.0
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+
+# Portacode
+
+**An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.**
+
+Portacode transforms any computer into a remotely accessible development environment. Access your home lab from your phone, code on your desktop from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
+
+## ✨ Why Portacode?
+
+- **🤖 AI-First**: Built from the ground up with AI integration in mind
+- **📱 Mobile-First**: Code and administrate from your phone or tablet
+- **🌍 Global Access**: Connect to your devices from anywhere with internet
+- **🔐 Secure**: HTTPS encrypted with RSA key authentication
+- **⚡ Fast Setup**: Get connected in under 60 seconds
+- **🔄 Always Connected**: Automatic reconnection and persistent service options
+- **🆓 Free Account**: Create your account and start connecting immediately
+- **🖥️ Cross-Platform**: Works on Windows, macOS, and Linux
+
+## 🚀 Quick Start
+
+### 1. Install Portacode
+
+```bash
+pip install portacode
+```
+
+### 2. Connect Your Device
+
+```bash
+portacode connect
+```
+
+Follow the on-screen instructions to:
+- Visit [https://remote.portacode.com](https://remote.portacode.com)
+- Create your free account
+- Add your device using the generated key
+- Start coding and administrating!
+
+### 3. Access Your Development Environment
+
+Once connected, you can:
+- Open terminal sessions from the web dashboard
+- Execute commands remotely
+- Monitor system status
+- Access your development environment from any device
+
+## 💡 Use Cases
+
+### Remote Development
+```bash
+# Connect your development machine
+portacode connect
+
+# Now code, build, and debug from anywhere - even your phone
+```
+
+### Server Administration
+```bash
+# For a persistent connection, install system-wide first
+sudo pip install portacode --system
+
+# Then install as a service
+sudo portacode service install
+
+# Your server is now accessible 24/7 from the web dashboard
+```
+
+### Mobile Development
+```bash
+# Connect your desktop/laptop
+portacode connect
+
+# Code on-the-go from your mobile device with a full IDE experience
+```
+
+### Team Collaboration
+```bash
+# Connect shared development environments
+portacode connect
+
+# Enable team members to access shared resources securely
+```
+
+## 🔧 Essential Commands
+
+### Basic Usage
+```bash
+# Start a connection (runs until closed)
+portacode connect
+
+# Run connection in background
+portacode connect --detach
+
+# Check version
+portacode --version
+
+# Get help
+portacode --help
+```
+
+### Service Management
+```bash
+# For system services, install package system-wide first
+sudo pip install portacode --system
+
+# Install persistent service (auto-start on boot)
+sudo portacode service install
+
+# Check service status
+sudo portacode service status
+
+# Stop the service
+sudo portacode service stop
+
+# Remove the service
+sudo portacode service uninstall
+```
+
+## 🌐 Web Dashboard
+
+Access your connected devices at [https://remote.portacode.com](https://remote.portacode.com)
+
+**Current Features:**
+- Real-time terminal access
+- System monitoring
+- Device management
+- Multi-device switching
+- Secure authentication
+
+**Coming Soon:**
+- AI-powered code assistance
+- Mobile-optimized IDE interface
+- File management and editing
+- Collaborative development tools
+
+## 🔐 Security
+
+- **RSA Key Authentication**: Each device gets a unique RSA key pair
+- **HTTPS Encrypted**: All communication is encrypted in transit
+- **No Passwords**: Key-based authentication eliminates password risks
+- **Revocable Access**: Remove devices instantly from the web dashboard
+- **Local Key Storage**: Private keys never leave your device
+
+## 🆘 Troubleshooting
+
+### Connection Issues
+```bash
+# Check if another connection is running
+portacode connect
+
+# View service logs
+sudo portacode service status --verbose
+```
+
+### Service Installation Issues
+```bash
+# If service commands fail, ensure system-wide installation
+sudo pip install portacode --system
+
+# Then try service installation again
+sudo portacode service install
+```
+
+### Clipboard Issues (Linux)
+```bash
+# Install clipboard support
+sudo apt-get install xclip
+```
+
+### Key Management
+Key files are stored in:
+- **Linux**: `~/.local/share/portacode/keys/`
+- **macOS**: `~/Library/Application Support/portacode/keys/`
+- **Windows**: `%APPDATA%\portacode\keys\`
+
+## 🌱 Early Stage Project
+
+**Portacode is a young project with big dreams.** We're building the future of remote development and mobile-first coding experiences. As a new project, we're actively seeking:
+
+- **👥 Community Feedback**: Does this solve a real problem for you?
+- **🤝 Contributors**: Help us build the IDE of the future
+- **📢 Early Adopters**: Try it out and let us know what you think
+- **💡 Feature Ideas**: What would make your remote development workflow better?
+
+**Your support matters!** Whether you contribute code, report bugs, share ideas, or simply let us know that you find value in what we're building - every bit of feedback helps us decide whether to continue investing in this vision or focus on other projects.
+
+## 📞 Get In Touch
+
+- **Email**: hi@menas.pro
+- **Support**: support@portacode.com
+- **GitHub**: [https://github.com/portacode/portacode](https://github.com/portacode/portacode)
+
+## 🤝 Contributing
+
+We welcome all forms of contribution:
+- 🐛 **Bug Reports**: Found something broken? Let us know!
+- ✨ **Feature Requests**: What would make Portacode better for you?
+- 📖 **Documentation**: Help others get started
+- 💻 **Code Contributions**: Help us build the future of remote development
+- 💬 **Feedback**: Tell us if you find this useful!
+
+Check out our [GitHub repository](https://github.com/portacode/portacode) to get started.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+**Get started today**: `pip install portacode && portacode connect`
+
+*Built with ❤️ and ☕ by passionate software engineers* 

portacode-0.3.dev20/README.md

@@ -0,0 +1,211 @@
+# Portacode
+
+**An AI-first, mobile-first IDE and admin tool, made with love and passion by software engineers, for software engineers.**
+
+Portacode transforms any computer into a remotely accessible development environment. Access your home lab from your phone, code on your desktop from anywhere, or help a colleague debug their server - all through a beautiful web interface designed for the modern developer.
+
+## ✨ Why Portacode?
+
+- **🤖 AI-First**: Built from the ground up with AI integration in mind
+- **📱 Mobile-First**: Code and administrate from your phone or tablet
+- **🌍 Global Access**: Connect to your devices from anywhere with internet
+- **🔐 Secure**: HTTPS encrypted with RSA key authentication
+- **⚡ Fast Setup**: Get connected in under 60 seconds
+- **🔄 Always Connected**: Automatic reconnection and persistent service options
+- **🆓 Free Account**: Create your account and start connecting immediately
+- **🖥️ Cross-Platform**: Works on Windows, macOS, and Linux
+
+## 🚀 Quick Start
+
+### 1. Install Portacode
+
+```bash
+pip install portacode
+```
+
+### 2. Connect Your Device
+
+```bash
+portacode connect
+```
+
+Follow the on-screen instructions to:
+- Visit [https://remote.portacode.com](https://remote.portacode.com)
+- Create your free account
+- Add your device using the generated key
+- Start coding and administrating!
+
+### 3. Access Your Development Environment
+
+Once connected, you can:
+- Open terminal sessions from the web dashboard
+- Execute commands remotely
+- Monitor system status
+- Access your development environment from any device
+
+## 💡 Use Cases
+
+### Remote Development
+```bash
+# Connect your development machine
+portacode connect
+
+# Now code, build, and debug from anywhere - even your phone
+```
+
+### Server Administration
+```bash
+# For a persistent connection, install system-wide first
+sudo pip install portacode --system
+
+# Then install as a service
+sudo portacode service install
+
+# Your server is now accessible 24/7 from the web dashboard
+```
+
+### Mobile Development
+```bash
+# Connect your desktop/laptop
+portacode connect
+
+# Code on-the-go from your mobile device with a full IDE experience
+```
+
+### Team Collaboration
+```bash
+# Connect shared development environments
+portacode connect
+
+# Enable team members to access shared resources securely
+```
+
+## 🔧 Essential Commands
+
+### Basic Usage
+```bash
+# Start a connection (runs until closed)
+portacode connect
+
+# Run connection in background
+portacode connect --detach
+
+# Check version
+portacode --version
+
+# Get help
+portacode --help
+```
+
+### Service Management
+```bash
+# For system services, install package system-wide first
+sudo pip install portacode --system
+
+# Install persistent service (auto-start on boot)
+sudo portacode service install
+
+# Check service status
+sudo portacode service status
+
+# Stop the service
+sudo portacode service stop
+
+# Remove the service
+sudo portacode service uninstall
+```
+
+## 🌐 Web Dashboard
+
+Access your connected devices at [https://remote.portacode.com](https://remote.portacode.com)
+
+**Current Features:**
+- Real-time terminal access
+- System monitoring
+- Device management
+- Multi-device switching
+- Secure authentication
+
+**Coming Soon:**
+- AI-powered code assistance
+- Mobile-optimized IDE interface
+- File management and editing
+- Collaborative development tools
+
+## 🔐 Security
+
+- **RSA Key Authentication**: Each device gets a unique RSA key pair
+- **HTTPS Encrypted**: All communication is encrypted in transit
+- **No Passwords**: Key-based authentication eliminates password risks
+- **Revocable Access**: Remove devices instantly from the web dashboard
+- **Local Key Storage**: Private keys never leave your device
+
+## 🆘 Troubleshooting
+
+### Connection Issues
+```bash
+# Check if another connection is running
+portacode connect
+
+# View service logs
+sudo portacode service status --verbose
+```
+
+### Service Installation Issues
+```bash
+# If service commands fail, ensure system-wide installation
+sudo pip install portacode --system
+
+# Then try service installation again
+sudo portacode service install
+```
+
+### Clipboard Issues (Linux)
+```bash
+# Install clipboard support
+sudo apt-get install xclip
+```
+
+### Key Management
+Key files are stored in:
+- **Linux**: `~/.local/share/portacode/keys/`
+- **macOS**: `~/Library/Application Support/portacode/keys/`
+- **Windows**: `%APPDATA%\portacode\keys\`
+
+## 🌱 Early Stage Project
+
+**Portacode is a young project with big dreams.** We're building the future of remote development and mobile-first coding experiences. As a new project, we're actively seeking:
+
+- **👥 Community Feedback**: Does this solve a real problem for you?
+- **🤝 Contributors**: Help us build the IDE of the future
+- **📢 Early Adopters**: Try it out and let us know what you think
+- **💡 Feature Ideas**: What would make your remote development workflow better?
+
+**Your support matters!** Whether you contribute code, report bugs, share ideas, or simply let us know that you find value in what we're building - every bit of feedback helps us decide whether to continue investing in this vision or focus on other projects.
+
+## 📞 Get In Touch
+
+- **Email**: hi@menas.pro
+- **Support**: support@portacode.com
+- **GitHub**: [https://github.com/portacode/portacode](https://github.com/portacode/portacode)
+
+## 🤝 Contributing
+
+We welcome all forms of contribution:
+- 🐛 **Bug Reports**: Found something broken? Let us know!
+- ✨ **Feature Requests**: What would make Portacode better for you?
+- 📖 **Documentation**: Help others get started
+- 💻 **Code Contributions**: Help us build the future of remote development
+- 💬 **Feedback**: Tell us if you find this useful!
+
+Check out our [GitHub repository](https://github.com/portacode/portacode) to get started.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+**Get started today**: `pip install portacode && portacode connect`
+
+*Built with ❤️ and ☕ by passionate software engineers* 

portacode-0.3.dev20/backup.sh

@@ -0,0 +1,42 @@
+# backup.sh
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ensure we’re in project root
+cd "$(dirname "$0")"
+
+# config
+BACKUP_DIR="${1:-$PWD/../backups}"
+VOLUME_NAME="portacode_pgdata"
+SERVICE_NAME="db"
+
+mkdir -p "$BACKUP_DIR"
+
+# check & stop DB for a consistent dump
+if [ "$(docker inspect -f '{{.State.Running}}' portacode-db 2>/dev/null || echo false)" = "true" ]; then
+  echo "🛑 Stopping $SERVICE_NAME..."
+  docker-compose stop "$SERVICE_NAME"
+  RESTART_DB=true
+else
+  RESTART_DB=false
+fi
+
+# create backup
+TS=$(date +%F_%H-%M-%S)
+FILE="pgdata-$TS.tar.gz"
+echo "📦 Backing up volume to $BACKUP_DIR/$FILE..."
+docker run --rm \
+  -v "${VOLUME_NAME}":/data:ro \
+  -v "${BACKUP_DIR}":/backup \
+  alpine \
+  sh -c "cd /data && tar czf /backup/${FILE} ."
+
+echo "✅ Backup complete."
+
+# restart DB if we stopped it
+if [ "$RESTART_DB" = true ]; then
+  echo "🔄 Starting $SERVICE_NAME..."
+  docker-compose start "$SERVICE_NAME"
+fi
+
+echo "🎉 Done."

portacode-0.3.dev20/docker-compose.yaml

@@ -0,0 +1,37 @@
+services:
+  db:
+    image: postgres:15
+    container_name: portacode-db
+    restart: unless-stopped
+    env_file:
+      - main.env
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U portacode -d portacode"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  django:
+    build:
+      context: ./server/portacode_django
+      dockerfile: Dockerfile
+    container_name: portacode-django
+    restart: unless-stopped
+    command: ["bash", "-c", "python manage.py migrate && python manage.py collectstatic --noinput && daphne portacode_django.asgi:application -b 0.0.0.0 -p 8001"]
+    env_file:
+      - main.env
+    depends_on:
+      db:
+        condition: service_healthy
+    ports:
+      - "8001:8001"
+    volumes:
+      - ./server/portacode_django:/app
+
+
+volumes:
+  pgdata: 

{portacode-0.2.6.dev0 → portacode-0.3.dev20}/portacode/_version.py

@@ -1,7 +1,14 @@
 # file generated by setuptools-scm
 # don't change, don't track in version control
 
-__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
@@ -9,13 +16,19 @@ if TYPE_CHECKING:
     from typing import Union
 
     VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
 else:
     VERSION_TUPLE = object
+    COMMIT_ID = object
 
 version: str
 __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
 
-__version__ = version = '0.2.6.dev'
-__version_tuple__ = version_tuple = (0, 2, 6, 'dev0')
+__version__ = version = '0.3.dev20'
+__version_tuple__ = version_tuple = (0, 3, 'dev20')
+
+__commit_id__ = commit_id = None