firstcut
firstcut is a first-principles project scaffolder for teams that want more than a folder template.
Run one command, answer four prompts, and get a project with:
- layered architecture for backend, frontend, monorepo, tooling, infrastructure, or docs projects
- AI context files for Claude Code, Codex, Cursor, and Windsurf
- embedded AI skills for domain modeling, TDD, interface design, implementation simplicity, and QA
- pre-commit hooks, CI templates, domain docs, and a 95% coverage culture baked in
Install
uv tool install firstcut
# or
pipx install firstcut
Use
firstcut init
firstcut init --defaults
firstcut init --defaults --project-name billing-api --output-dir ./scratch
firstcut init --defaults --config ./firstcut.toml
Interactive prompts can be cancelled with cancel, exit, quit, or q.
Example config
project_type = "backend"
language = "python"
framework = "fastapi"
pkg_manager = "uv"
project_name = "billing-api"
ci = ["github-actions"]
skills = ["tdd", "qa", "implementation-simplicity"]
Project status
firstcut is alpha software. The Python CLI is the canonical runtime; npm and Go launcher wrappers live in the source repository for cross-ecosystem distribution.
See the full README and source at: https://github.com/shailvshah/firstcut
1 maintainer
Metadata
1 maintainer
Release files for firstcut 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| firstcut-0.1.0.tar.gz | 115.1 kB | Without provenance | Details for firstcut-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| firstcut-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for firstcut-0.1.0-py3-none-any.whl |
Total release size: 149.8 kB
Release files / firstcut-0.1.0.tar.gz
| Download URL | firstcut-0.1.0.tar.gz |
|---|---|
| Size | 115.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8b2feb685a3da24a13be46d6bb944f3f7a78df3afca5e76f94ab48c442769c43
|
|
BLAKE2b-256 checksum How to use checksums |
fdace5d3792e3361b9baf96e39b632da1ed9c1cb90bd570b076b6225022d3f63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / firstcut-0.1.0-py3-none-any.whl
| Download URL | firstcut-0.1.0-py3-none-any.whl |
|---|---|
| Size | 34.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
67a455f0085f6cb90f225863859218211a103925564d15b8f90d4e2dd28667fc
|
|
BLAKE2b-256 checksum How to use checksums |
86989171293c019c6fe73e9f4c7203c59c402a96b89c53820fb4180c1ccb1518
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for firstcut 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
