vcspull import codecommit

Import repositories from AWS CodeCommit.

Command

Import repositories from AWS CodeCommit.

Usage

usage: vcspull import codecommit [-h] [-w DIR] [-l LANG] [--topics TOPICS]
                                 [--min-stars N] [--archived] [--forks]
                                 [--limit N] [-f FILE] [--dry-run] [--yes]
                                 [--json] [--ndjson] [--https]
                                 [--color {auto,always,never}]
                                 [--region REGION] [--profile PROFILE]
                                 [TARGET]

Positional Arguments

target TARGET

Optional substring filter for repository names

Default

Options

-w, --workspace DIR

Workspace root directory (REQUIRED)

Default
None
--region REGION

AWS region for CodeCommit

Default
None
--profile PROFILE

AWS profile for CodeCommit

Default
None

Filtering

-l, --language LANG

Filter by programming language

Default
None
--topics TOPICS

Filter by topics (comma-separated)

Default
None
--min-stars N

Minimum stars (for search mode)

Default
0
Type
int
--archived

Include archived repositories

Default
False
--forks

Include forked repositories

Default
False
--limit N

Maximum repositories to fetch (default: 100)

Default
100
Type
int

Output

-f, --file FILE

Config file to write to (default: ~/.vcspull.yaml)

Default
None
--dry-run, -n

Preview without writing to config file

Default
False
--yes, -y

Skip confirmation prompt

Default
False
--json

Output as JSON

Default
False
--ndjson

Output as NDJSON (one JSON per line)

Default
False
--https

Use HTTPS clone URLs instead of SSH (default: SSH)

Default
False
--color

When to use colors (default: auto)

Default
auto
Choices
auto, always, never

Usage

CodeCommit does not require a target argument. Use --region and --profile to select the AWS environment:

$ vcspull import codecommit \
    --workspace ~/code/ \
    --region us-east-1 \
    --profile work

Authentication

  • Auth: AWS CLI credentials (aws configure) — no token env var

  • CLI args: --region, --profile

  • IAM permissions required:

    • codecommit:ListRepositories (resource: *)

    • codecommit:BatchGetRepositories (resource: repo ARNs or *)

  • Dependency: AWS CLI must be installed (pip install awscli)

Configure your AWS credentials:

$ aws configure

Then import:

$ vcspull import codecommit \
    --workspace ~/code/ \
    --region us-east-1