Local AI Runtime Layer

A unified OS-like runtime for all AI development tools.
End port hell forever.

Phase 1a v0.1.0 Windows 10/11

The Problem

AI coding tools frequently cause chaos in your local environment

⚠️

Port Conflicts

Multiple AI agents fight over ports 3000-3999, causing random failures

🧟

Zombie Processes

Background servers left running, consuming resources indefinitely

🔑

Credential Chaos

Tokens and secrets scattered across tools with no central management

Phase 1a: Port Manager

The first piece of Gosiki OS - end port conflicts forever

✅ Port Acquisition

Automatically find and allocate available ports

📝 Registry Management

Track allocated ports in ~/.gosiki-os/port-registry.json

🔓 Port Release

Free up allocated ports when you're done

📊 List Allocations

View all currently allocated ports with metadata

Installation

npm Package

npm install @gosiki-os/port-manager

CLI Usage

# Acquire a port
npx @gosiki-os/port-manager 3000

# Release a port
npx @gosiki-os/port-manager --release 3001

# List all allocations
npx @gosiki-os/port-manager --list

# Show help
npx @gosiki-os/port-manager --help

Node.js API

import { acquirePort, releasePort, listAllocations } from '@gosiki-os/port-manager';

// Acquire a port
const port = await acquirePort(3000);
console.log(`Using port ${port}`);

// Release a port
await releasePort(port);

// List all allocations
const allocations = await listAllocations();

⚠️ Execution Requirements

✅ Supported

  • Claude Code Terminal (VS Code)
  • Windows 10/11 (PowerShell + Node.js v18+)
  • macOS/Linux/WSL2 (coming in v0.2)

❌ Not Supported

  • ChatGPT WebUI/Desktop
  • Claude WebUI
  • Cursor AI Editor
  • GitHub Codespaces/Cloud Shell

You MUST run this in Claude Code Terminal (VS Code).
Browser-based AI environments cannot access your local OS.

Roadmap

Building the future of AI-assisted development

Phase 1a

Port Manager

✅ Available Now (v0.1.0)

  • Port acquisition & release
  • Registry management
  • Windows 10/11 support
Phase 1b-1c

Process Manager & Folder Policy

Q1 2026

  • Process lifecycle management
  • Zombie cleanup
  • Workspace structure enforcement
Phase 2

IDE Abstraction Layer

Q2-Q3 2026

  • Cursor support
  • Multi-IDE compatibility
  • Unified adapter system
Phase 3

Boundary OS

Q4 2026

  • Token Manager
  • GitHub Auth layer
  • Complete AI chaos prevention

Ready to end port hell?

Start using Gosiki OS Port Manager today

Get Started on GitHub
npm install @gosiki-os/port-manager