alknet/tasks/cli/connect-command.md at 596c89ce24ac5974512a57ccd0380bde81818af8

Files

glm-5.1 596c89ce24 refactor!: rebrand wraith to alknet

Rename all crates, CLI commands, constants, type names, doc comments,
and documentation from wraith to alknet. Includes wire-protocol changes:
ALPN wraith-ssh -> alknet-ssh, reserved destination prefix wraith- ->
alknet-, SSH auth username wraith -> alknet.

2026-06-05 10:04:32 +00:00

2.0 KiB

Raw Blame History

id, name, status, depends_on, scope, risk, impact, level

name

status

depends_on

scope

risk

impact

level

cli/connect-command

Implement `alknet connect` CLI subcommand with clap

pending

client/connect-options

moderate

low

component

implementation

Description

Implement the alknet connect CLI subcommand using clap with derive macros. Translates ConnectOptions into CLI flags and runs the client session. All options from client.md CLI interface must be supported.

Environment variable defaults: ALKNET_SERVER, ALKNET_IDENTITY as convenience defaults per ADR-011.

--proxy with --transport tcp should warn or be a no-op (ADR-019: client proxy wraps transport, and TCP transport is already direct).

Acceptance Criteria

alknet connect subcommand flags match client.md CLI interface: --server, --peer, --transport, --identity, --socks5, --forward, --remote-forward, --proxy, --iroh-relay, --tls-server-name, --insecure
--server required for tcp/tls transport (validated at parse time or runtime)
--peer required for iroh transport (validated)
--identity required for all transports
--transport defaults to tcp
--socks5 defaults to 127.0.0.1:1080
--forward is repeatable (clap multiple_occurrences)
--remote-forward is repeatable
Environment variable defaults: ALKNET_SERVER for --server, ALKNET_IDENTITY for --identity
--proxy with --transport tcp prints warning (ADR-019: effectively no-op)
CLI translates args into ConnectOptions and calls ClientSession::new(opts).run().await
Errors reported to stderr with non-zero exit code
cargo run -p alknet -- connect --help shows all flags with descriptions

References

docs/architecture/client.md — CLI Interface section with all flags
docs/architecture/decisions/011-no-ssh-config-programmatic-api.md — env var defaults
docs/architecture/decisions/019-proxy-dual-semantics.md — client proxy semantics

Notes

To be filled by implementation agent

Summary

To be filled on completion

2.0 KiB Raw Blame History