From 8abe9b1d9c04e91b48d179182e2502b73b42fb44 Mon Sep 17 00:00:00 2001 From: Rishi Jat Date: Fri, 27 Feb 2026 08:19:56 +0530 Subject: [PATCH 1/5] docs: replace hardcoded storage-dir default path with generic home directory Signed-off-by: Rishi Jat --- build/package/docs/modctl.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/package/docs/modctl.1.md b/build/package/docs/modctl.1.md index 18528d03..7a9930aa 100644 --- a/build/package/docs/modctl.1.md +++ b/build/package/docs/modctl.1.md @@ -29,7 +29,7 @@ Available Commands: Flags: -h, --help help for modctl - --storage-dir string specify the storage directory for modctl (default "/Users/qiwenbo/.modctl") + --storage-dir string specify the storage directory for modctl (default "~/.modctl") ``` # BUGS From cd5a997efb1ebf1bffebed87c7806ded51b8f597 Mon Sep 17 00:00:00 2001 From: Rishi Jat Date: Fri, 27 Feb 2026 08:29:28 +0530 Subject: [PATCH 2/5] docs: add missing CLI commands to modctl man page Signed-off-by: Rishi Jat --- build/package/docs/modctl.1.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/build/package/docs/modctl.1.md b/build/package/docs/modctl.1.md index 7a9930aa..c1de2743 100644 --- a/build/package/docs/modctl.1.md +++ b/build/package/docs/modctl.1.md @@ -26,6 +26,12 @@ Available Commands: pull A command line tool for modctl pull push A command line tool for modctl push rm A command line tool for modctl rm + attach A command line tool for modctl attach + fetch A command line tool for modctl fetch + tag A command line tool for modctl tag + upload A command line tool for modctl upload + version A command line tool for modctl version + modelfile A command line tool for modctl modelfile Flags: -h, --help help for modctl From 8d1f49feb842394e483f229a8e2ce95a3f3506ce Mon Sep 17 00:00:00 2001 From: Rishi Jat Date: Fri, 27 Feb 2026 08:31:46 +0530 Subject: [PATCH 3/5] copilot suggestion Signed-off-by: Rishi Jat --- build/package/docs/modctl.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/package/docs/modctl.1.md b/build/package/docs/modctl.1.md index c1de2743..b1949ade 100644 --- a/build/package/docs/modctl.1.md +++ b/build/package/docs/modctl.1.md @@ -35,7 +35,7 @@ Available Commands: Flags: -h, --help help for modctl - --storage-dir string specify the storage directory for modctl (default "~/.modctl") + --storage-dir string specify the storage directory for modctl (default $HOME/.modctl) ``` # BUGS From 05605abc1c35c76129f0f6b2619496e3c6cf67ad Mon Sep 17 00:00:00 2001 From: Rishi Jat Date: Fri, 27 Feb 2026 12:17:06 +0530 Subject: [PATCH 4/5] did maintainer suggestion and cleaup Signed-off-by: Rishi Jat --- build/package/docs/modctl.1.md | 45 ++++++++++++++++++++-------------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/build/package/docs/modctl.1.md b/build/package/docs/modctl.1.md index b1949ade..f622fe29 100644 --- a/build/package/docs/modctl.1.md +++ b/build/package/docs/modctl.1.md @@ -1,41 +1,48 @@ -% MODCTL(1) Version v2.2.0 | Frivolous "Modctl" Documentation +% MODCTL(1) Version v0.1.2 | modctl Documentation # NAME -**modctl** — A command line tool for managing artifact bundled based on the Model Format Specification +**modctl** — A command line tool for managing artifacts bundled based on the ModelPack Specification ## OPTIONS ```shell -A command line tool for managing artifact bundled based on the Model Format Specification +A command line tool for managing artifacts bundled based on the ModelPack Specification Usage: modctl [flags] modctl [command] Available Commands: - build A command line tool for modctl build + attach Attach the file to an existing model artifact. + build Build the model artifact with the context by specified path. completion Generate the autocompletion script for the specified shell - extract A command line tool for modctl extract + extract Extract the model artifact to the output path, which can restore the initial state of the model files. + fetch Fetch can retrieve files from the remote model repository, enabling selective download of partial model files by filtering based on file path patterns. help Help about any command - inspect A command line tool for modctl inspect - login A command line tool for modctl login - logout A command line tool for modctl logout - ls A command line tool for modctl list - prune A command line tool for modctl prune - pull A command line tool for modctl pull - push A command line tool for modctl push - rm A command line tool for modctl rm - attach A command line tool for modctl attach - fetch A command line tool for modctl fetch - tag A command line tool for modctl tag - upload A command line tool for modctl upload + inspect Inspect can help to analyze the composition of model artifact. + login Login to a registry. + logout Logout from a registry. + ls List the current built model artifacts from local storage. + modelfile A command line tool for modelfile operation + prune Prune can help to cleanup useless manifests and blobs in the local storage. + pull Pull a model artifact from the remote registry. + push Push a model artifact to the remote registry. + rm Remove a model artifact from the local storage. + tag Tag can tag one model artifact to another one without rebuilding. + upload Upload a file to the remote end in advance to save time in the later build, applicable to the scenario of uploading while downloading, this function needs to be used together with build. version A command line tool for modctl version - modelfile A command line tool for modctl modelfile Flags: -h, --help help for modctl - --storage-dir string specify the storage directory for modctl (default $HOME/.modctl) + --log-dir string specify the log directory for modctl (default "~/.modctl/logs") + --log-level string specify the log level for modctl (default "info") + --no-progress disable progress bar + --pprof enable pprof + --pprof-addr string specify the address for pprof (default "localhost:6060") + --storage-dir string specify the storage directory for modctl (default "~/.modctl") + +Use "modctl [command] --help" for more information about a command. ``` # BUGS From 1df4a58fa455e0ce6a0a63dd87c42dc6e4031d4b Mon Sep 17 00:00:00 2001 From: Rishi Jat Date: Fri, 27 Feb 2026 14:35:28 +0530 Subject: [PATCH 5/5] align modctl man page with CLI output Signed-off-by: Rishi Jat --- build/package/docs/modctl.1.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/build/package/docs/modctl.1.md b/build/package/docs/modctl.1.md index f622fe29..08ef8c6e 100644 --- a/build/package/docs/modctl.1.md +++ b/build/package/docs/modctl.1.md @@ -2,15 +2,14 @@ # NAME -**modctl** — A command line tool for managing artifacts bundled based on the ModelPack Specification +**modctl** — A command line tool for managing artifact bundled based on the ModelPack Specification ## OPTIONS ```shell -A command line tool for managing artifacts bundled based on the ModelPack Specification +A command line tool for managing artifact bundled based on the ModelPack Specification Usage: - modctl [flags] modctl [command] Available Commands: @@ -23,13 +22,13 @@ Available Commands: inspect Inspect can help to analyze the composition of model artifact. login Login to a registry. logout Logout from a registry. - ls List the current built model artifacts from local storage. + ls List will lists the current built model artifacts from local storage. modelfile A command line tool for modelfile operation prune Prune can help to cleanup useless manifests and blobs in the local storage. pull Pull a model artifact from the remote registry. push Push a model artifact to the remote registry. rm Remove a model artifact from the local storage. - tag Tag can tag one model artifact to another one without rebuilding. + tag Tag can tag one model artifact to another one without rebuiding. upload Upload a file to the remote end in advance to save time in the later build, applicable to the scenario of uploading while downloading, this function needs to be used together with build. version A command line tool for modctl version