comitup-cli(8)

✨ comitup-cli 💅

okay bestie, so this is the manual page for comitup-cli, a little command-line bestie that talks to the comitup(8) network management service 💖 she's part of section 8 (system administration), and she's here to make your wifi situation make sense.

---

🌸 NAME 🌸

comitup-cli — the command-line interface for comitup network management, fr fr 🎀

---

✨ SYNOPSIS ✨

$ `comitup-cli`

State: HOTSPOT
Connection: hotspot-123
Points:
    1: MyAccessPoint
    2: HisAccessPoint
Available Commands:
    (r)eload
    (q)uit
    connect to (<n>)
command?:

like... you literally just run it and she starts talking to you 💬 no cap.

---

💜 DESCRIPTION 💜

The comitup-cli utility gives you access to the comitup(8) D-Bus interface. It's meant to be a debug tool and also a source-code example for how to connect to that interface — so she's useful and she's teaching, main character energy honestly 🫶

if the comitup(8) service is not running, comitup-cli will exit immediately. no service, no vibes, sorry bestie 😭

🦋 Display 🦋

here's what she shows you:

• State

The comitup states are HOTSPOT, CONNECTING, and CONNECTED.

In the HOTSPOT mode, comitup creates a wifi hotspot with the name comitup-<nnn>, where <nnn> is a persistent number.

Once in HOTSPOT mode, the system will occasionally (~1/min) cycle through available defined connections, by transitioning to the CONNECTING mode. The Access Point list is updated by this process. Any command issued by comitup-cli will cause the next timeout instance to be skipped. 👀

Once a connection is established, the system will be in the CONNECTED mode. If the connection is lost, failed, or deleted, the system will transition back to the HOTSPOT state.

• Connection

The ssid of the current active connection.

• Points

While in the HOTSPOT mode, comitup-cli will list the currently-visible access points, by ssid. Access points with the strongest signal are sorted to the top of the list. The entries are numbered, for use with the connect command.

🎀 Commands 🎀

• r — Reload

Refresh the displayed state, mode, and list of access points.

• q — Quit

Exit comitup.cli.

• d — Delete connection

Delete the configuration information for the current wifi connection. This will cause comitup to transition to the HOTSPOT mode.

this command is not available in the HOTSPOT mode. not her moment, she's sitting this one out 🙈

• <n> — Connect to access point <n>

Define a connection for the selected access point, and then attempt to connect.

this command is only available in the HOTSPOT mode. periodt.

• m — Manual connection

Enter an SSID manually.

• i — Get information

Return the comitup version and host name for the current instance.

---

👑 COPYRIGHT 👑

Comitup is Copyright (C) 2016-2019 David Steele <steele@debian.org> 💖

---

🌈 SEE ALSO 🌈

comitup(8), comitup-conf(5), comitup-web(8) — go read those too, iykyk ✨

---

and that's the whole page bestie 🫶 this version is dated February 2019 and lives in section comitup-cli(8) — okay bye, go connect to something 🔥💅