vpnctl is a cross-platform CLI tool designed to help users manage Cisco Secure Client VPN connections efficiently from the terminal.
- Connect/Disconnect to VPN profiles (
intra
,dev
) - Show VPN status
- Launch/Kill Cisco Secure Client GUI
- Manage credentials (store, fetch, update, remove) securely
- Auto-detect Cisco Secure Client installation
- Developer-friendly auto-build/watch mode
- Rohan Das
- Email: dev.work.rohan@gmail.com
Download the latest release: download vpnctl
# detect the binary(your download directory)
# unzip it if ziped
# move the executable to /bin directory
$ cp vpnctl_v2.3.0 /usr/local/bin/vpnctl
# make it executable
$ chmod +x /usr/local/bin/vpnctl
# verify the installation
$ vpnctl
# Note: Allow the binary in secuirty center in Settings, SystemPreferance > Security & Privacy > General > Allow apps downloaded from: "App Store and identified developers" or "Anywhere" if you have that option.
Coming soon...
After installing vpnctl
, you can use the following commands:
Command | Description |
---|---|
vpnctl status |
Show VPN status |
vpnctl connect intra |
Connect using intra profile |
vpnctl connect dev |
Connect using dev profile |
vpnctl disconnect |
Disconnect VPN and kill GUI |
vpnctl kill |
Kill Cisco Secure Client GUI only |
vpnctl gui |
Launch Cisco GUI |
vpnctl credential update |
Update your credential |
vpnctl credential fetch |
Fetch your existing credential |
vpnctl credential remove |
Remove your existing credential |
vpnctl help |
Show help message |
vpnctl info |
Show version and author info |
vpnctl connect intra
vpnctl status
vpnctl credential update
vpnctl disconnect
If you encounter any bugs or issues, please open an issue in the Issues section before submitting a pull request (PR). This helps us track and discuss problems before code changes are proposed.
We welcome contributions! Please follow these steps:
- Fork the repository and create your branch from
main
. - Open an issue to discuss your proposed change before working on a PR.
- Make your changes with clear, concise commits.
- Ensure your code passes all tests and lint checks.
- Submit a pull request referencing the related issue.
By contributing, you agree to follow our Code of Conduct and help us maintain a welcoming community.
MIT License. See LICENSE for details.
- Ensure Cisco Secure Client is installed and in your system
PATH
. - Credentials are stored securely using the system keyring.