A terminal UI for managing containers on macOS using the native container CLI.

• Container Management: List, start, stop, restart, and remove containers
• Image Management: List, pull, inspect, and remove images
• Network Management: List, create, inspect, and remove networks
• Volume Management: List, create, inspect, and remove volumes
• Vim-style Navigation: Use j/k or arrow keys for navigation
• Search/Filter: Quickly filter resources with /
• Real-time Refresh: Auto-refresh data with r key
• Detailed Inspection: View full resource details with Enter or i
• Container Logs: View container logs with L

• macOS with native container support
• Node.js >= 18.0.0
• The container CLI must be installed and the container service running

# Install globally
npm install -g @rotorsoft/contui

# Run the CLI
contui

# Or run without installing
npx @rotorsoft/contui

# Clone the repository
git clone https://github.com/Rotorsoft/contui.git
cd contui

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Run the application
pnpm start

# Link for global usage
pnpm link --global

# Run from anywhere
contui

# Run in development mode with hot reload
pnpm dev

# Type check
pnpm run typecheck

# Lint
pnpm run lint

# Run tests
pnpm test

# Run tests with coverage
pnpm run test:coverage

# Format code
pnpm run format

The application is built with:

• Ink: React for CLI applications
• TypeScript: Type-safe development
• React Hooks: State management with useState, useCallback, useEffect

src/
├── components/      # React components (views, dialogs, UI elements)
├── hooks/           # Custom React hooks
├── services/        # Container CLI wrapper and utilities
├── types/           # TypeScript type definitions
└── index.tsx        # Application entry point

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Make your changes
4. Run validation:

   pnpm run typecheck
   pnpm run lint
   pnpm test

5. Commit using Conventional Commits:

   git commit -m "feat: add amazing feature"

6. Push and open a Pull Request

This project uses conventional commits enforced by commitlint:

• feat: New feature
• fix: Bug fix
• docs: Documentation changes
• style: Code style changes (formatting, etc.)
• refactor: Code refactoring
• perf: Performance improvements
• test: Test additions or corrections
• build: Build system changes
• ci: CI configuration changes
• chore: Maintenance tasks

MIT