@git.zone/tsview

A CLI tool for viewing S3 and MongoDB data with a web UI.

Installation

npm install -g @git.zone/tsview
# or
pnpm add -g @git.zone/tsview

Usage

CLI

# Start viewer (auto-finds free port from 3010+)
tsview

# Force specific port
tsview --port 3000

# S3 viewer only
tsview s3

# MongoDB viewer only
tsview mongo

Configuration

tsview reads configuration from .nogit/env.json (the same format used by gitzone service):

{
  "S3_ENDPOINT": "localhost",
  "S3_PORT": "9000",
  "S3_ACCESSKEY": "minioadmin",
  "S3_SECRETKEY": "minioadmin",
  "S3_USESSL": false,
  "MONGODB_URL": "mongodb://localhost:27017",
  "MONGODB_NAME": "mydb"
}

Programmatic API

import { TsView } from '@git.zone/tsview';

const viewer = new TsView();

// Option 1: Load from env.json (gitzone service)
await viewer.loadConfigFromEnv();

// Option 2: Custom local config (MinIO + local MongoDB)
viewer.setS3Config({
  endpoint: 'localhost',
  port: 9000,
  accessKey: 'minioadmin',
  accessSecret: 'minioadmin',
  useSsl: false
});

// Option 3: Cloud config (AWS S3 + MongoDB Atlas)
viewer.setS3Config({
  endpoint: 's3.amazonaws.com',
  accessKey: 'AKIAXXXXXXX',
  accessSecret: 'secret',
  useSsl: true,
  region: 'us-east-1'
});

viewer.setMongoConfig({
  mongoDbUrl: 'mongodb+srv://user:pass@cluster.mongodb.net',
  mongoDbName: 'mydb'
});

// Start on auto-found port
const port = await viewer.start();
console.log(`Viewer running on http://localhost:${port}`);

// Or force specific port
await viewer.start(3500);

// Stop when done
await viewer.stop();

Features

S3 Browser

• Column View: Mac Finder-style navigation with horizontal columns
• List View: Flat list of all keys with filtering
• Preview Panel: View images, text, and JSON files
• Operations: Download, delete files

MongoDB Browser

• Database/Collection Navigation: Hierarchical sidebar
• Documents Table: Paginated view with filtering
• Document Editor: Edit documents with JSON syntax highlighting
• Index Management: View, create, and drop indexes

Development

# Install dependencies
pnpm install

# Build (bundles UI + compiles TypeScript)
pnpm build

# Run tests
pnpm test

# Run in development mode
./cli.ts.js

License

MIT License - see license for details.