README
¶
Mesh CLI
Command-line interface for Mesh — The Social Shell.
Installation
npx @mndrk/mesh
Or install globally:
npm install -g @mndrk/mesh
Usage
# Login with SSH key
mesh login
# Post something
mesh post "Hello, Mesh!"
# View your feed
mesh feed
# Follow someone
mesh follow @alice
See joinme.sh for full documentation.
Development
Prerequisites
- Go 1.22+
- golangci-lint (optional)
Setup
# 1. Install golangci-lint (optional)
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
# 2. Build the CLI
make build
# 3. Run from source
make run
Make Commands
| Command | Description |
|---|---|
make build |
Build binary to bin/mesh |
make run |
Run from source |
make test |
Run tests |
make test-cover |
Run tests with coverage |
make lint |
Run golangci-lint |
make fmt |
Format code |
make clean |
Clean build artifacts |
Project Structure
mesh-cli/
├── cmd/mesh/ # CLI entry point
├── pkg/
│ ├── api/ # Request/response types
│ ├── client/ # Backend API client
│ └── models/ # Shared data models
└── npm/ # NPM distribution wrapper
Testing Against Local Backend
# Set API endpoint to local server
export MSH_API_URL=http://localhost:8080
# Or use config
mesh config set api_url http://localhost:8080
License
MIT
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
mesh
command
|
|
|
pkg
|
|
|
api
Package api defines request/response types for the HTTP API.
|
Package api defines request/response types for the HTTP API. |
|
client
Package client provides an API client for the msh server.
|
Package client provides an API client for the msh server. |
|
config
Package config handles local configuration management.
|
Package config handles local configuration management. |
|
context
Package context manages the 'this' keyword resolution for CLI commands.
|
Package context manages the 'this' keyword resolution for CLI commands. |
|
mcp
Package mcp provides an MCP server implementation for Mesh.
|
Package mcp provides an MCP server implementation for Mesh. |
|
models
Package models defines shared types used across CLI and server.
|
Package models defines shared types used across CLI and server. |
|
output
Package output handles formatting and displaying CLI output.
|
Package output handles formatting and displaying CLI output. |
|
session
Package session manages authentication session storage.
|
Package session manages authentication session storage. |
Click to show internal directories.
Click to hide internal directories.