Update Docs

Author: simone-panico

Makefile

@@ -184,6 +184,7 @@ integration: init-block
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLIRunLifecycle || exit_code=1 ; \
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLIExecCommand || exit_code=1 ; \
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLICreateCommand || exit_code=1 ; \
+		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLICopyCommand || exit_code=1 ; \
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLIRunCommand1 || exit_code=1 ; \
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLIRunCommand2 || exit_code=1 ; \
 		$(SWIFT) test -c $(BUILD_CONFIGURATION) $(SWIFT_CONFIGURATION) --filter TestCLIRunCommand3 || exit_code=1 ; \

docs/command-reference.md

@@ -424,6 +424,39 @@ container stats --no-stream web
 container stats --format json --no-stream web
 ```
 
+### `container copy (cp)`
+
+Copies files between a container and the local filesystem. The container must be running. One of the source or destination must be a container reference in the form `container_id:path`.
+
+**Usage**
+
+```bash
+container copy [--debug] <source> <destination>
+```
+
+**Arguments**
+
+*   `<source>`: Source path (local path or `container_id:path`)
+*   `<destination>`: Destination path (local path or `container_id:path`)
+
+**Path Format**
+
+*   Local path: `/path/to/file` or `relative/path`
+*   Container path: `container_id:/path/in/container`
+
+**Examples**
+
+```bash
+# copy a file from host to container
+container cp ./config.json mycontainer:/etc/app/
+
+# copy a file from container to host
+container cp mycontainer:/var/log/app.log ./logs/
+
+# copy using the full command name
+container copy ./data.txt mycontainer:/tmp/
+```
+
 ### `container prune`
 
 Removes stopped containers to reclaim disk space. The command outputs the amount of space freed after deletion.

docs/how-to.md

@@ -60,6 +60,31 @@ total 4
 %
 </pre>
 
+## Copy files between host and container
+
+Use `container copy` (or the short alias `container cp`) to transfer files between a running container and your local filesystem. 
+
+To copy a local file into a running container:
+
+<pre>
+% echo "hello" > greeting.txt
+% container cp greeting.txt mycontainer:/tmp/
+% container exec mycontainer cat /tmp/greeting.txt
+hello
+%
+</pre>
+
+To copy a file from a container to the host:
+
+<pre>
+% container cp mycontainer:/etc/hostname ./hostname.txt
+% cat hostname.txt
+mycontainer
+%
+</pre>
+
+The path format uses a colon to distinguish container paths from local paths: `container_id:/path/in/container`. One of the source or destination must always be a container reference. The container must be running for the copy to succeed.
+
 ## Build and run a multiplatform image
 
 Using the [project from the tutorial example](tutorial.md#set-up-a-simple-project), you can create an image to use both on Apple silicon Macs and on x86-64 servers.