HacktrackMMU CLI

cli tool for hacktrack cuz why not

---

Getting Started

Installation

Quick Install (via curl)

You can install ht using the following curl command:

curl -fsSL https://raw.githubusercontent.com/hackerspacemmu/hacktrackmmu-cli/main/install.sh | bash

From Source

1. Clone or copy this repository to your local machine:

   git clone https://github.com/hackerspacemmu/hacktrackmmu-cli.git
   cd hacktrackmmu-cli

2. Initialize and tidy dependencies:

   go mod tidy

---

Usage Guide

Root Command

ht [flags]

Flags:

• -v, --verbose: Enable debug level structured logs (overrides log_level config value).

---

Commands

1. Authenticate (login)

Authenticate with the Hacktrack MMU server using your password.

ht login [password]

2. Ping Server (ping)

Ping the Hacktrack API server before running other requests (recommended when cold starting).

ht ping

3. View Member Details (view)

View details of a specific member.

ht view [name]

4. Meetup Management (meetup)

Manage meetups.

• Create a meetup interactively:

  ht meetup create

5. Project Management (project)

Manage projects.

• Create a project:

  ht project create

6. Update Management (update)

Manage updates/contributions for members.

• Create an update interactively:

  ht update create

7. Version (version)

Print compilation details:

ht version

Print in JSON format:

ht version --json

---

Building and Running

Prerequisites

• Go (1.21+ recommended, currently configured for latest via mise)
• make (optional, for running task automation)

You can use the provided Makefile to simplify development tasks:

Tasks

• Build the binary:

  make build

  This places the compiled binary in bin/ht with injected build information.

• Run the CLI directly:

  make run ARGS="version"
  # Or with flags:
  make run ARGS="version -v"

• Run tests:

  make test

• Format code:

  make fmt

• Install to global GOBIN:

  make install

  ---

Adding New Commands

To add a new subcommand to the CLI, use the cobra-cli binary:

# If not already installed:
go install github.com/spf13/cobra-cli@latest

# Add a command:
cobra-cli add <command-name>

Alternatively, you can manually create a new file in cmd/<command-name>.go following the pattern in cmd/version.go:

package cmd

import (
        "fmt"
        "github.com/spf13/cobra"
       )

var myCmd = &cobra.Command{
Use:   "mycmd",
         Short: "A brief description",
         Run: func(cmd *cobra.Command, args []string) {
cfg := GetConfig() // Access the configuration
       fmt.Println("Running mycmd...")
         },
}

func init() {
  rootCmd.AddCommand(myCmd)
}

---

Configuration

The CLI load order for configurations is:

1. Local flags (e.g. --verbose)
2. Environment Variables (prefixed with HACKTRACK_)
3. Configuration file (defaults to config.yaml in the working directory, or $HOME/.config/hacktrackmmu-cli/config.yaml)
4. Struct Defaults

Configuration File Template

Create a config.yaml file in the root of the project to customize settings:

# config.yaml
log_level: info
api_url: "api-url"