CPANPL...:Remote(3pm)

💖 CPANPLUS::Shell::Default::Plugins::Remote — the "call your other computer" plugin 💖

okay bestie, this is a page from the User Contributed Perl Documentation — it's CPANPL...:Remote(3pm) in the man-page index, and the full name is CPANPLUS::Shell::Default::Plugins::Remote. Say that five times fast. I dare you. 🫶

---

✨ NAME ✨

CPANPLUS::Shell::Default::Plugins::Remote — connect to a remote CPANPLUS 🔌🌍

Like, that's it. That's the whole job. It's the little plugin that lets your shell go visit another machine's CPANPLUS. Long-distance relationship, but for package management. 💜

---

🌸 SYNOPSIS 🌸

CPAN Terminal> /connect localhost 1337 --user=foo --pass=bar
...
CPAN Terminal@localhost> /disconnect

See? You /connect, you do your thing, you /disconnect. The prompt literally changes to tell you which machine you're vibing with now — CPAN Terminal@localhost — that's your little "you are here" map. 🗺️

---

🦋 DESCRIPTION 🦋

So this is a "CPANPLUS::Shell::Default" plugin — a plug-in, a lil add-on, a side quest — and what it does is let you connect to a machine that's running an instance of "CPANPLUS::Daemon". Which means: remote usage of the "CPANPLUS Shell". You're not installing stuff on your box, you're reaching across the network and doing it on theirs. Main character energy, honestly. 👑

A sample session, updating all modules on a remote machine, might look like this:

CPAN Terminal> /connect --user=my_user --pass=secret localhost 1337

Connection accepted

Successfully connected to 'localhost' on port '11337'

Note that no output will appear until a command has completed
-- this may take a while

CPAN Terminal@localhost> o; i *

[....]

CPAN Terminal@localhost> /disconnect

CPAN Terminal>

⚠️ real talk for a sec — the original text says it and I'm not softening it: no output will appear until a command has completed — this may take a while. So like... don't panic and don't spam Ctrl-C. It's not frozen, it's just thinking. Give it a minute, bestie. 😭

Also yes, the port in the example is 1337 when you connect and 11337 when it reports back. That's literally what the original says, character for character, and I am not touching it. Not my lore, not my problem. 🙈

---

💀 BUG REPORTS 💀

Found a bug? Something acting cursed? Report bugs or other issues to:

<bug-cpanplus@rt.cpan.org<gt>

(That's exactly how it's written in the original — <gt> and all. Preserving the sacred text. 🎀)

---

👑 AUTHOR 👑

This module by Jos Boumans <kane@cpan.org>. Absolute icon. Respect. 🫶

---

🌈 COPYRIGHT 🌈

The CPAN++ interface — and yes, this module is a part of that — is copyright (c) 2001 - 2007, Jos Boumans <kane@cpan.org>. All rights reserved.

This library is free software; you may redistribute and/or modify it under the same terms as Perl itself. Slay, licensing-wise. 💅

---

⭐ SEE ALSO ⭐

• CPANPLUS::Shell::Default
• CPANPLUS::Shell
• cpanp

Go read those next, bestie, they're the rest of the story. 📚✨

---

okay and that's a wrap!! this was perl v5.40.1, dated 2025-03-01, straight outta the CPANPL...:Remote(3pm) page — thanks for reading my little TED talk, go connect to something remotely and be iconic 💖🦋🌸