toss-dev-server

Automate local development server startup for TaillogToss with Metro and FastAPI.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/Jason-hub-star/TaillogToss --skill toss-dev-server
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: toss-dev-server
Source: https://github.com/Jason-hub-star/TaillogToss/tree/main/.agents/skills/toss-guide/ops/toss-dev-server
Command: npx skills add https://github.com/Jason-hub-star/TaillogToss --skill toss-dev-server

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the setup and startup of TaillogToss's local development server, coordinating Metro and FastAPI to reduce manual steps and errors during boot.

Core Features & Use Cases

  • Stop existing server processes and clear stale state to ensure a clean start.
  • Establish necessary adb reverse ports for Metro (8081) and FastAPI (8000) to enable full-stack communication.
  • Load environment variables from .env and launch Metro, followed by the backend server, with proper working directories.
  • Validate startup by checking process health and endpoint responses, and provide quick recovery steps if failures occur.

Quick Start

Run the startup procedure to stop existing processes, configure the environment, and launch Metro and FastAPI.

Frequently Asked Questions about toss-dev-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start the local dev server for Metro and FastAPI?

To start the local dev server, run the automated procedure to stop existing processes, load environment variables, establish adb reverse ports, and launch Metro and FastAPI.

Why does my Metro bundle fail to load during local development?

Your Metro bundle may fail due to stale state or missing adb reverse port configurations. The startup procedure clears existing processes and establishes port 8081 to ensure reliable boot.

What prerequisites are needed to run the FastAPI backend and Metro server?

You need adb installed, a valid .env file, and correct project paths for both Metro and Backend to initialize the development stack and establish full-stack communication.

How do I fix FastAPI endpoints being unavailable during local development?

FastAPI endpoints are unavailable if the backend server fails to boot. The startup procedure establishes adb reverse port 8000 and validates endpoint responses to provide quick recovery steps.

Can I automate adb reverse port setup for Metro and FastAPI?

Yes, the local development server startup automates adb reverse port configuration for Metro on 8081 and FastAPI on 8000 to enable full-stack communication without manual steps.

What should I do if the local dev server process does not pass health checks?

If health checks fail, the startup procedure provides quick recovery steps by validating process health and endpoint responses after attempting a clean start with proper working directories.