open-index/open-npm huggingface dataset:
npm package: @opeoginni/gitterm-agent
Description: Tunnel agent for exposing local development ports through gitterm.dev
Author: Opeyemi Oginni
Latest version: 0.1.13

# @opeoginni/gitterm-agent

A lightweight tunnel agent that securely exposes **local development ports** through your **gitterm.dev** workspace URL.

## Installation

```bash
# Run directly with npx (recommended)
npx @opeoginni/gitterm-agent

# Or install globally
npm install -g @opeoginni/gitterm-agent
```

## Quick Start

### 1. Login to GitTerm

```bash
npx @opeoginni/gitterm-agent login
```

This will open a browser for authentication. Once logged in, your credentials are saved locally.

### 2. Connect Your Local Server

```bash
# Start your local server first
opencode serve --port 3000  # or whatever starts your server on port 3000

# Then connect it to your gitterm workspace
npx @opeoginni/gitterm-agent connect --workspace-id "your-workspace-id" --port 3000
```

That's it! Your local server is now accessible at `https://your-subdomain.gitterm.dev`.

## Commands

### `login`

Sign in via device-code flow.

```bash
npx @opeoginni/gitterm-agent login
```

### `logout`

Clear saved credentials.

```bash
npx @opeoginni/gitterm-agent logout
```

### `connect`

Connect a local port to your gitterm workspace.

```bash
npx @opeoginni/gitterm-agent connect --workspace-id <id> --port <number>
```

**Required options:**
- `--workspace-id <id>` - Your workspace ID
- `--port <number>` - Local port to expose

**Optional:**
- `--expose <name=port>` - Expose additional ports (repeatable)
- `--ws-url <url>` - Custom tunnel proxy URL (default: wss://tunnel.gitterm.dev/tunnel/connect)
- `--server-url <url>` - Custom API server URL (default: https://api.gitterm.dev)
- `--token <jwt>` - Tunnel JWT (overrides saved login)

## Examples

### Basic Usage

```bash
# Expose a local dev server
npx @opeoginni/gitterm-agent connect --workspace-id "ws_abc123" --port 3000
```

### Multiple Ports

Expose additional services as subdomains:

```bash
npx @opeoginni/gitterm-agent connect \
  --workspace-id "ws_abc123" \
  --port 3000 \
  --expose api=3001 \
  --expose docs=4000
```

This maps:
- `https://your-subdomain.gitterm.dev` -> `localhost:3000`
- `https://your-subdomain-api.gitterm.dev` -> `localhost:3001`
- `https://your-subdomain-docs.gitterm.dev` -> `localhost:4000`


## How It Works

1. The agent opens an outbound WebSocket connection to the GitTerm tunnel proxy
2. Authenticates using your saved credentials or a provided JWT
3. Proxies HTTP requests from your `*.gitterm.dev` URL to your local port
4. Supports streaming responses (SSE, WebSocket upgrades coming soon)

## Notes

- This tool does **not** start servers for you. Run your local server first, then connect.
- Credentials are stored in `~/.config/gitterm/agent.json`
- The tunnel stays open until you press Ctrl+C

## License

MIT
npm package: @opeolluwa/filewindow
Description: A React file viewer for the web 
Author: Adeoye Adefemi
Latest version: 0.0.7

 # FileWindow

- [Description](#description)
- [Getting Started](#getting-started)
  - [Dependencies](#dependencies)
  - [Installing](#installing)
  - [Executing program](#executing-program)
- [Documentation](#documentation)
- [Help](#help)
- [Authors](#authors)
- [Version History](#version-history)
- [License](#license)
- [Acknowledgments](#acknowledgments)

## Description

Extended React File viewer for the web

## Getting Started

### Dependencies

- Describe any prerequisites, libraries, OS version, etc., needed before installing program.
- ex. Windows 10

### Installing

- How/where to download your program
- Any modifications needed to be made to files/folders

### Executing program

- How to run the program
- Step-by-step bullets

```
code blocks for commands
```

## Documentation

Describe any special instructions that are necessary to install a software package on your computer (if applicable).

## Help

Any advise for common problems or issues.

```
command to run if program contains helper info
```

## Authors

Contributors names and contact info

ex. Dominique Pizzie  
ex. [@DomPizzie](https://twitter.com/dompizzie)

## Version History

- 0.2
  - Various bug fixes and optimizations
  - See [commit change]() or See [release history]()
- 0.1
  - Initial Release

## License

This project is licensed under the [NAME HERE] License - see the LICENSE.md file for details

## Acknowledgments

Inspiration, code snippets, etc.
npm package: @opeolluwa/thunderstorm
Description: A Command Line tool for automating creation of server side application
Author: Adeoye Adefemi Opeoluwa
Latest version: 2.1.1

# ThunderStorm

A Command Line tool for quickly setting up server side application

## Features

- Simple
- Lightweight
- creates folders using best practice
- initialize project with packages
- ships with `package.json` and eliminates need for `npm init`

## Installation

Thunderstorm is distributed with `npm` which ships with Node.js, to begin [install Node.js](https://nodejs.org), if you don't have it installed, then run `npm i -g @opeolluwa/thunderstorm`

## Usage/Examples

`thunderstorm` uses `bash` under the hood to execute package installation of application dependencies. Ensure to install `bash` shell before you execute `npm run make` or `yarn make`, depending on your preferred package manager. You could choose to copy the content on `install.sh` instead and execute it in your preferred Command Line Interface (terminal) when the project has been generated

- initialize a new basic project

```bash
$ thunderstorm init <application-name>

```

- initialize a project with packages

```bash
$ thunderstorm init <application-name> -p <package_01> <package_02> ...

```

- initialize a project with packages and environment variables

```bash

$ thunderstorm init <application-name> -p <package_01> <package_02> ...  -e <VARIABLE_01=value_01> <VARIABLE_02=value_02> ...

```

- See the initialization guide option

```bash
$ thunderstorm help init
```

- 

## Demo

![demo](./thunderstorm.png)

## Run Locally

Clone the project

```bash
  git clone https://github.com/opeolluwa/thunderstorm
```

Go to the project directory

```bash
  cd thunderstorm
```

Install dependencies

```bash
  npm install
```

Start the server

```bash
  ./index.js
```

## Contributing

Contributions are always welcome!

See `contributing.md` for ways to get started.

Please adhere to this project's `code of conduct`.

## Feedback

If you have any feedback, please reach out to us at adefemiadeoye@yahoo.com

## 🚀 About Me

**Hi, I'm Opeoluwa! 👋**

A full stack developer devoted to building community projects...

If you find ThunderStorm helpful, consider [buying me pizza 🍕](https://getfidia.com/pay/opeolluwa/open-source)