.:i:SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r J r SSKrSSKrSSKJr SSKJr SSKJrJrJr SSKJr SS KJr SS KJr SS KJr SS K J!r! SS K"J#r# SSK$r$SSK%r%SSK&r&SSK'J'r'J(r( \&RR"\%RT5r+\RX"\+S9r-SS\.S-S\.S-4Sjjr/SS\.S-S\04Sjjr1S\RdS\04Sjr3S\4S\RdS\.S\.4Sjr50SSSSSS._SSS S!S"S._S#S$S%S&S"S._S'S(S)SSS._S*S+S,S-S"S._S.S.S/S0S"S._S1S2S3S4S"S._S5S6S7SSS._S8S9S:SSS._S;SS"S._S?S@SASBS"S._SCSDSESFS"S._SGSHSISSS._SJSKSLSMS"S._SNSOSPSQS"S._SRSSSTSUS"S._SVSWSXSSS._r6SYSZS[.r7\ Rp"5S\- S]- S- r9S^r:S_r;"S`Sa5r\"5r?"SgSh\#5r@\R"SiSjSS"\@Sk9rBSlrC\BR5Sm\R4Snj5rDSSo\F\.Sp\GSq\GSr\GS\ \.4 SsjjrHSSt\.Su\ uvx specify-cli.py init . uvx specify-cli.py init --here Or install globally: uv tool install --from specify-cli.py specify-cli specify init specify init . specify init --here N)Path)OptionalTuple)Console)Panel)Progress SpinnerColumn TextColumn)Text)Live)Align)Table)Tree) TyperGroup)datetimetimezoneverify cli_tokenreturncU=(d< [R"S5=(d [R"S5=(d SR5=(d S$)zAReturn sanitized GitHub token (cli arg takes precedence) or None.GH_TOKEN GITHUB_TOKENN)osgetenvstrip)rs N/home/james-whalen/.local/lib/python3.13/site-packages/specify_cli/__init__.py _github_tokenr;s9  R"))J/ R299^3L RPR Y Y [ d`ddc8[U5nU(aSSU30$0$)zDReturn Authorization header dict only when a non-empty token exists. AuthorizationzBearer )r)rtokens r_github_auth_headersr$?s% ) $E38Owug. /@b@r headersc0nSU;aURS5US'SU;aURS5US'SU;a`[URSS55nU(a>[R"U[R S9nX!S'X1S 'UR 5US 'S U;a"URS 5n[U5US 'U$U$![a XAS 'U$f=f)z,Extract and parse GitHub rate-limit headers.zX-RateLimit-LimitlimitzX-RateLimit-Remaining remainingzX-RateLimit-Reset0)tz reset_epoch reset_time reset_localz Retry-Afterretry_after_seconds retry_after)getintr fromtimestamprutc astimezone ValueError)r%infor+r,r/s r_parse_rate_limit_headersr7Ds Dg% $78W ')#KK(?@[g%'++&93?@ !//  MJ"- !+ ","7"7"9D kk-0  .*-k*:D& ' K4K  ."-  K  .s5CCC status_codeurlcx[U5nSUSU3/nURS5 U(aURS5 SU;aURSUSS35 SU;aURS US35 S U;a(US RS 5nURS U35 S U;aURSUS S35 URS5 URS5 URS5 URS5 URS5 URS5 SRU5$)zAFormat a user-friendly error message with rate-limit information.zGitHub API returned status z for rz$[bold]Rate Limit Information:[/bold]r'u • Rate Limit: z requests/hourr(u • Remaining: r-z%Y-%m-%d %H:%M:%S %Zu • Resets at: r.u • Retry after: z secondsz"[bold]Troubleshooting Tips:[/bold]uQ • If you're on a shared CI or corporate environment, you may be rate-limited.uS • Consider using a GitHub token via --github-token or the GH_TOKEN/GITHUB_TOKENz1 environment variable to increase rate limits.uW • Authenticated requests have a limit of 5,000/hour vs 60/hour for unauthenticated. )r7appendstrftimejoin)r8r%r9 rate_infolines reset_strs r_format_rate_limit_errorrB`s9)'2I*;-uSE B CE LL ;< i  LL-i.@-AP Q ) # LL,Y{-C,DE F I %!-099:PQI LL,YK8 9 I - LL.y9N/O.PPXY Z R LL56 LLde LLfg LLDE LLjk 99U r copilotzGitHub Copilotz.github/F)namefolder install_url requires_cliclaudez Claude Codez.claude/z4https://docs.anthropic.com/en/docs/claude-code/setupTgeminiz Gemini CLIz.gemini/z+https://github.com/google-gemini/gemini-cliz cursor-agentCursorz.cursor/qwenz Qwen Codez.qwen/z#https://github.com/QwenLM/qwen-codeopencodez .opencode/zhttps://opencode.aicodexz Codex CLIz.codex/zhttps://github.com/openai/codexwindsurfWindsurfz .windsurf/kilocodez Kilo Codez .kilocode/auggiez Auggie CLIz .augment/z@https://docs.augmentcode.com/cli/setup-auggie/install-auggie-cli codebuddy CodeBuddyz .codebuddy/zhttps://www.codebuddy.ai/cliqoderz Qoder CLIz.qoder/zhttps://qoder.com/cliroozRoo Codez.roo/qzAmazon Q Developer CLIz .amazonq/z:https://aws.amazon.com/developer/learning/q-developer-cli/ampAmpz.agents/z"https://ampcode.com/manual#installshaiSHAIz.shai/zhttps://github.com/ovh/shaibobzIBM Bobz.bob/zPOSIX Shell (bash/zsh) PowerShell)shpsz.claudelocalu/ ███████╗██████╗ ███████╗ ██████╗██╗███████╗██╗ ██╗ ██╔════╝██╔══██╗██╔════╝██╔════╝██║██╔════╝╚██╗ ██╔╝ ███████╗██████╔╝█████╗ ██║ ██║█████╗ ╚████╔╝ ╚════██║██╔═══╝ ██╔══╝ ██║ ██║██╔══╝ ╚██╔╝ ███████║██║ ███████╗╚██████╗██║██║ ██║ ╚══════╝╚═╝ ╚══════╝ ╚═════╝╚═╝╚═╝ ╚═╝ z1GitHub Spec Kit - Spec-Driven Development Toolkitc\rSrSrSrS\4SjrSrS\S\4SjrSS\S \4S jjr SS\S \4S jjr SS\S \4S jjr SS\S \4S jjr S\S\S \4Sjr SrSrSrg) StepTrackerzTrack and render hierarchical steps without emojis, similar to Claude Code tree output. Supports live auto-refresh via an attached refresh callback. titlecFXl/UlSSSSSS.UlSUlg)Nr)pendingrunningdoneerrorskipped)rcsteps status_order _refresh_cb)selfrcs r__init__StepTracker.__init__s*  ()aQ[\]r cXlgN)rp)rqcbs rattach_refreshStepTracker.attach_refreshsr keylabelcXRVs/sHo3SPM sn;a0URRXSSS.5 UR5 ggs snf)Nryrirryrzstatusdetail)rnr<_maybe_refresh)rqryrzss raddStepTracker.addsK 4Ax4 4 JJ  cYZ\] ^    ! 54sAr~c&URUSUS9 g)Nrjr}r~_updaterqryr~s rstartStepTracker.start S6 :r c&URUSUS9 g)Nrkrrrs rcompleteStepTracker.complete s S 7r c&URUSUS9 g)Nrlrrrs rrlStepTracker.error s S 8r c&URUSUS9 g)Nrmrrrs rskipStepTracker.skiprr r}cURH-nUSU:XdMX$S'U(aX4S'UR5 g URRXX#S.5 UR5 g)Nryr}r~r|)rnrr<)rqryr}r~rs rrStepTracker._updates`Ax3$( "(hK##%  #vXY r cjUR(aUR5 gg![a gf=fru)rp Exception)rqs rrStepTracker._maybe_refreshs5      "   s % 22c[SURS3SS9nURHnUSnUS(aUSR5OSnUSnUS :XaS nO&US :XaS nOUS :XaSnOUS:XaSnO US:XaSnOSnUS :XaU(a USUSUS3nO$USUS3nOU(a USUSUS3nOUSUS3nUR U5 M U$)N[cyan][/cyan]grey50) guide_stylerzr~rr}rku[green]●[/green]riu[green dim]○[/green dim]rju[cyan]○[/cyan]rlu[red]●[/red]rmu[yellow]○[/yellow] z [bright_black] (z)[/bright_black][/bright_black]z [white]z[/white] [bright_black](z[/white])rrcrnrr)rqtreesteprz detail_textr}symbollines rrenderStepTracker.render&sfTZZL0hGJJDME48N$x...0K(^F-9$59$+7")9$/"$X_UG2k]JZ$X_UG?KD$XXeW4L[MYijD$XXeWH=D HHTN?@ r )rprornrcN)r)__name__ __module__ __qualname____firstlineno____doc__strrrrwrrrrlrrrr__static_attributes__r rraras c "s"3" ;;c;8C8899c9;;S; 3  S "r rac[R"5nU[RR:XdU[RR:XagU[RR :XdU[RR :XagU[RR:XagU[RR:XagU[RR:Xa[eU$)z=Get a single keypress in a cross-platform way using readchar.updownenterescape) readcharreadkeyryUPCTRL_PDOWNCTRL_NENTERESCCTRL_CKeyboardInterrupt)rys rget_keyrJs    C hlloo (;(;!; hll3(,,*=*=#= hll    hll hll!!! Jr options prompt_text default_keyc@^^^^^^[TR55mU(aUT;aTRU5mOSmSmUUUU4Sjm[R 5 UUUU4SjnU"5 Tc+[R S5 [ R "S5eT$)a Interactive selection using arrow keys with Rich Live display. Args: options: Dict with keys as option keys and values as descriptions prompt_text: Text to show above the options default_key: Default option key to start with Returns: Selected option key rNc ~>[R"SS9nURSSSS9 URSSS9 [T5HEupUT:XaUR S S US TUS 35 M)UR S S US TUS 35 MG UR SS5 UR SS5 [ USTS3SSS9$)z>Create the selection panel with current selection highlighted.rrf)paddingcyanleftrg)stylejustifywidthwhiterru▶rz[/cyan] [dim](z)[/dim]rruB[dim]Use ↑/↓ to navigate, Enter to select, Esc to cancel[/dim]z[bold]z[/bold]rerfrc border_styler)rgrid add_column enumerateadd_rowr)tableiry option_keysrrselected_indexs rcreate_selection_panel2select_with_arrows..create_selection_panelrs 6* vvQ? w7 ,FAN" evcU.g%VW cVC5ws|nG#TU -  b" b^_ ;-w/   r c>[T"5[SSS9n[5nUS:XaTS- [T5-mOUUS:XaTS-[T5-mO=US:XaTTmOHUS:Xa+[R S 5 [ R "S5eURT"5SS 9 MSSS5 g![a, [R S 5 [ R "S5ef=f!,(df  g=f) NTF)console transient auto_refreshrrerrrz% [yellow]Selection cancelled[/yellow])refresh) r rrlenprinttyperExitupdater)liveryrrr selected_keys rrun_selection_loop.select_with_arrows..run_selection_loops (*GtZ_ `dh(!)Cd{*81*<K@P)P*81*<K@P)P'2>'B  &NO#jjm+KK 6 8$KGa `")(MM"JK**Q-'(#a `s0C*AB1C* AB1&C*16C''C** C8z [red]Selection failed.[/red]re)listkeysindexrrrr)rrrrrrrrs`` @@@@rselect_with_arrowsr^sw||~&K{k1$**;7L  , MMO((. 67jjm r c,^\rSrSrSrU4SjrSrU=r$) BannerGroupiz+Custom group that shows banner before help.c8>[5 [TU] X5 gru) show_bannersuper format_help)rqctx formatter __class__s rrBannerGroup.format_helps  C+r r)rrrrrrr __classcell__)rs@rrrs5,,r rspecifyz7Setup tool for Specify spec-driven development projects)rDhelpadd_completioninvoke_without_commandclsc [R5RS5n/SQn[5n[ U5H(up4X[ U5-nUR US-US9 M* [R[R"U55 [R[R"[[SS955 [R5 g)zDisplay the ASCII art banner.r;) bright_bluebluer bright_cyanr bright_whiterzitalic bright_yellowN) BANNERrsplitr rrr<rrr centerTAGLINE) banner_linescolors styled_bannerrrcolors rrrs<<>''-L TFFM\*3v;'TD[6+ MM%,,}-. MM%,,tG3IJKL MMOr rcURcrS[R;a]S[R;aH[5 [R [ R"S55 [R 5 gggg)z+Show banner when no subcommand is provided.Nz--helpz-hz5[dim]Run 'specify --help' for usage information[/dim])invoked_subcommandsysargvrrrr r)rs rcallbackrsZ %(#((*BtSVS[S[G[  ell#Z[\ H\*B%r cmd check_returncaptureshellc U(a1[R"XSSUS9nURR5$[R"XUS9 g![RanU(a[ R SSRU535 [ R SUR35 [US5(a3UR(a"[ R S UR35 eSnAgSnAff=f) z2Run a shell command and optionally capture output.T)checkcapture_outputtextr)rrNz"[red]Error running command:[/red] rz[red]Exit code:[/red] stderrz[red]Error output:[/red] ) subprocessrunstdoutrCalledProcessErrorrrr> returncodehasattrr)rrrrresultes r run_commandr s ^^CDW[chiF==&&( ( NN3% @  ( (  MM>sxx}oN O MM21<<.A Bq(## 9!((DE s7AAD$BC>>DtooltrackercBUS:XaL[R5(a3[R5(aU(aURUS5 g[R "U5SLnU(a-U(aURUS5 U$UR US5 U$)zCheck if a tool is installed. Optionally update tracker. Args: tool: Name of the tool to check tracker: Optional StepTracker to update with results Returns: True if tool is found, False otherwise rH availableTNz not found)CLAUDE_LOCAL_PATHexistsis_filershutilwhichrl)r!r"founds r check_toolr+s x  # # % %*;*C*C*E*E  {3 LL d *E    T; / L MM$ , Lr pathcUc[R"5nUR5(dg[R"/SQSSUS9 g![R [ 4a gf=f)z7Check if the specified path is inside a git repository.F)gitz rev-parsez--is-inside-work-treeT)rrcwd)rr/is_dirrrrFileNotFoundError)r,s r is_git_repor2s` |xxz ;;==  9    ) )+< =sA A'&A' project_pathquietc[R"5n[R"U5 U(d[R S5 [ R"SS/SSSS9 [ R"/SQSSSS9 [ R"/SQSSSS9 U(d[R S5 [R"U5 g ![ RanS S RUR5S UR3nUR(a!US URR53- nO1UR(a USURR53- nU(d[R SU35 SU4sSnA[R"W5 $SnAff=f![R"W5 f=f)zInitialize a git repository in the specified path. Args: project_path: Path to initialize git repository in quiet: if True suppress console output (tracker handles status) Returns: Tuple of (success: bool, error_message: Optional[str]) z+[cyan]Initializing git repository...[/cyan]r.initT)rrr)r.r.)r.commitz-mz$Initial commit from Specify templateu-[green]✓[/green] Git repository initialized)TNz Command: rz Exit code: z Error: z Output: z.[red]Error initializing git repository:[/red] FN)rr/rchdirrrrrrr>rrrrr)r3r4 original_cwdr error_msgs r init_git_repor<sVxxz   MMG Hvd4dS*$tRVWV^bswC D MMI J   ( (  0 all^L 88 9QXX^^%5$67 7I XX :ahhnn&6%78 8I MMJ1#N Oi    s1B.CF-B0F( F- F0(F--F00GcL^^^SUUU4Sjjn[USSS9n[R"U5nSSS5 UR5(a][ UWT=(a T(+S9n[USSS9n[R "XS S 9 UR S 5 SSS5 U"S S5 g[R"X5 U"S S5 g!,(df  N=f!,(df  NI=f![a,n U"SU 3S5 [R"X5 Sn A gSn A ff=f)z9Handle merging or copying of .vscode/settings.json files.greencb>T(a'T(d[RSUSUST35 ggg)N[]z[/] )rr)messager rel_pathr"verboses rlog#handle_vscode_settings..log<s. 7 MMAeWAgYd8*= >#7r rutf-8encodingN)rDwrh)indentr;zMerged:z#Copied (no existing settings.json):rz+Warning: Could not merge, copying instead: yellow)r>) openjsonloadr&merge_json_filesdumpwriter(copy2r) sub_item dest_filerCrDr"rEf new_settingsmergedrs ``` rhandle_vscode_settingsrZ:s??* (C' 2a99Q3 2 87 * 9! =xH X))*sL C-C AC-2'CC-+C- CC- C*&C-- D#7"DD# existing_path new_contentrDc\^[USSS9n[R"U5nSSS5 S[ S[ S[ 4U4SjjmT"WU5nU(a"[ RS UR35 U$!,(df  N\=f![[R4a Us$f=f) aMerge new JSON content into existing JSON file. Performs a deep merge where: - New keys are added - Existing keys are preserved unless overwritten by new content - Nested dictionaries are merged recursively - Lists and other values are replaced (not merged) Args: existing_path: Path to existing JSON file new_content: New JSON content to merge in verbose: Whether to print merge details Returns: Merged JSON content as dict rGrHrINbaserrc>UR5nUR5HIup4X2;a;[X#[5(a$[U[5(aT"X#U5X#'MEXBU'MK U$)z-Recursively merge update dict into base dict.)copyitems isinstancedict)r^rrryvalue deep_merges rre$merge_json_files..deep_mergejs` ,,.JC}FK!>!>:eUYCZCZ(e< $s ) r z[cyan]Merged JSON file:[/cyan] ) rNrOrPr1JSONDecodeErrorrcrrrD)r[r\rDrWexisting_contentrYres @rrQrQRs" -w 71#yy| 8  t  (+ 6F 7 8J8J7KLM M/8 7 t33 4s- B A;B ; B B B B+*B+r] script_typerD show_progressclientdebug github_token ai_assistant download_dirrjrkrlrmrnc  SnSn Uc[R"[S9nU(a[R S5 SUSU S3n UR U SS [ U5S 9n U Rn U S :wa=[XRU 5n U(aU S U RSS 3- n [U 5eU R5nUR S/5nSUSU3nUVs/sH+nUUS;dMUSR'S5(dM)UPM- nnU(aUSOSnUc[R SUSUS35 UVs/sHnUR SS5PM nn[R [S R)U5=(d S!S"S#S95 ["R$"S5eUS$nUSnUS%nU(aM[R S&U35 [R S'US(S)35 [R S*US+35 UU- nU(a[R S,5 UR+S-US.S [ U5S 9n U RS :waH[U RU RU5n U(aU S/U RSS3- n [U 5e[-U RR S0S55n[/US15nUS:Xa(U R1S2S39HnUR3U5 M OU(a[5[75[9S45[9S55[S69nUR;S7US89nSn U R1S2S39H2nUR3U5 U [=U5- n UR?UU S99 M4 SSS5 O'U R1S2S39HnUR3U5 M SSS5 SSS5 U(a[R SNgithubspec-kitrz3[cyan]Fetching latest release information...[/cyan]https://api.github.com/repos///releases/latestTtimeoutfollow_redirectsr%z, [dim]Response body (truncated 500):[/dim] izFailed to parse release JSON: z Raw (truncated 400): iz-[red]Error fetching release information[/red]z Fetch Errorredrcrreassetszspec-kit-template--rDz.ziprz5[red]No matching release asset found[/red] for [bold]z![/bold] (expected pattern: [bold]z[/bold])?r;z (no assets)zAvailable AssetsrMbrowser_download_urlsizez[cyan]Found template:[/cyan] z[cyan]Size:[/cyan] ,z bytesz[cyan]Release:[/cyan] tag_namez$[cyan]Downloading template...[/cyan]GET<z, [dim]Response body (truncated 400):[/dim] zcontent-lengthwbi ) chunk_sizez([progress.description]{task.description}z-[progress.percentage]{task.percentage:>3.0f}%)rzDownloading...)total) completedz%[red]Error downloading template[/red]zDownload Errorz Downloaded: )filenamerrelease asset_url)"httpxClient ssl_contextrrr0r$r8rBr%r RuntimeErrorrOr5rrrrrendswithr>streamr1rN iter_bytesrSrr r add_taskrrr&unlink)#rorprjrDrkrlrmrn repo_owner repo_nameapi_urlresponser}r; release_datajerr~patternassetmatching_assetsa asset_names download_urlr file_sizezip_path total_sizerWchunkprogresstask downloadedr~metadatas# rdownload_template_from_githubr}sAJI ~[1 KL-j\9+EUVG:: !(6   %% S=09I9I7SINx}}]a^aObNcdd y) ) r#==?L  h +F"<.+?G!!% eFm # (-f (>(>v(F 6 #2OA tE } Ml^[|~E}FFNO P39:6aquuVS)6 : eDIIk2CmK]ltuvjjm/0LV}Hf I 5hZ@A +Ia=?@ .|J/G.HIJh&H <>* ]]  !(6  ##s*4X5I5I8K[K[]ij #RS[S`S`aebeSfRg!hhI"9--X--112BAFGJh%?!)!4!4!4!E"F%%)O&'QR&'VW$+  &#+#4#45EZ#4#XD)*J)1)<)<)<)M ! *c%j 8 (  K*N&.%8%8D%8%IEGGEN&J'& T XJ/0 +! H X m r!?tCZ[c[h[himjm[nZopq q r  EG eCF-eLMjjm;L &%  F  =?Q ??   OO  eF*:OPjjm sA*P.1O> R0R RR3SB R>A R-9AR0R-R> S> P+P&&P++P.. R8AR  R R* &R-- R; 7R>> S S S UA9UUrDr"rlrmrnis_current_dirc l[R"5n U(aURSS5 [UU UU=(a USLUSLUUUS9upU(aGUR SSU SSU SS S 35 UR S S 5 UR S U S 5 U(a$UR SS5 URS5 OU(a[RS5 U(dURSS9 [R"U S5n U R5nU(a0URS5 UR S[U5S35 O)U(a"[RS[U5S35 U(Ga[ R""5n[U5nU R%U5 ['UR)55nU(a1URS5 UR SS[U5S35 O)U(a"[RS[U5S35 Un[U5S:XadUSR+5(aLUSnU(a$UR S S!5 UR S 5 OU(a[RS"5 UR)5GHnUUR,- nUR+5(GaUR/5(aU(a)U(d"[RS#UR,35 UR1S$5HnUR35(dMUR5U5nUU- nUR6RSSS%9 UR,S&:Xa*UR6R,S':Xa[9UUUXE5 M[:R<"UU5 M GM![:R>"UU5 GM;UR/5(a0U(a)U(d"[RS(UR,35 [:R<"UU5 GM U(aU(d[RS)5 SSS5 GOU R%U5 ['UR)55nU(a0URS5 UR S[U5S*35 OrU(ak[RS[U5S+US,35 UH@n[RS-UR,SUR+5(aS.OS/S035 MB [U5S:XaUSR+5(aUSnUR6UR,S13- n[:R@"[U5[U55 URC5 [:R@"[U5[U55 U(a$UR S S!5 UR S 5 OU(a[RS25 SSS5 U(aUR S5 U(aUR S7S85 U R/5(aSU RM5 U(aUR S75 U$U(a"[RS9U R,35 U$![ aHn U(aURS[U 55 eU(a[RSU 35 eSn A ff=f!,(df  GN=f!,(df  GN=f![ an U(aURS[U 55 OMU(aF[RS3U 35 U(a'[R[E[U 5S4S5S695 U(d+UR/5(a[:RF"U5 [HRJ"S5eSn A ff=f!U(aUR S7S85 U R/5(aTU RM5 U(aUR S75 fU(a#[RS9U R,35 fff=f):zDownload the latest release and extract it to create a new project. Returns project_path. Uses tracker if provided (with keys: fetch, download, extract, cleanup) fetchzcontacting GitHub APINrizrelease rrrrz bytes)downloadDownload templaterz'[red]Error downloading template:[/red] extractExtract templatezExtracting template...T)parentsrGzip-listz entriesz[cyan]ZIP contains z items[/cyan]extracted-summaryztemp z itemsz[cyan]Extracted z items to temp location[/cyan]rerflattenzFlatten nested directoryz-[cyan]Found nested directory structure[/cyan]z$[yellow]Merging directory:[/yellow] *)rexist_okz settings.jsonz.vscodez#[yellow]Overwriting file:[/yellow] z9[cyan]Template files merged into current directory[/cyan]z top-level itemsz items to z:[/cyan] - dirfile)_tempz1[cyan]Flattened nested directory structure[/cyan]z&[red]Error extracting template:[/red] zExtraction Errorr|r}cleanupzRemove temporary archivez Cleaned up: )'rr/rrrrrrlrrrmkdirzipfileZipFilenamelistrtempfileTemporaryDirectory extractallriterdirr0rDr&rglobr' relative_toparentrZr(rTcopytreemovermdirrrmtreerrr)r3rorjrrDr"rlrmrn current_dirrmetarzip_ref zip_contentstemp_dir temp_pathextracted_items source_diritem dest_pathrUrCrV nested_dir temp_move_dirs rdownload_and_extract_templaters((*K g676  #/4"d?%      Wi0ADLQRCSSZ&[ \ KK $7 8   Zj)9 : I12 i  ./l>   t  , __Xs +w"++-L j)  L0A/B(-KL 3C 4E3FmTU002h $XI&&y1&*9+<+<+>&?O &9:(()<c/FZE[[a>bc  (8_9M8NNl&mn!*J?+q0_Q5G5N5N5P5P%4Q%7 "#KK 3MN#,,Y7$#MM,Y[ * 2 2 4$0499$< ;;==(//11#*7$+MM4XY]YbYbXc2d$e04 3H'/'7'7'9'93;3G3G3M4=4H (1(8(8(>(>tVZ(>([+4>>_+LQZQaQaQfQfjsQs,B8YX`bi,s,2LL9,M1@!'i @(//11gg ' 0STXT]T]S^._ `"LLy9+!5,w (acW32Z""<0"&|';';'=">MM"56$$%8S=Q ??   OO   +  X]]O<= y   MM'3q6 *  GsKL 632, +`    MM)SV , FqcJKMM%A6HW\"]^,"5"5"7"7 MM, 'jjm   KK #= > ??   OO   + X]]O<= sA-[,%-]%B] F1]D&];G] ]%`/, \>6A\99\> ] ] ]"]%% `,/B8`''`,,`//Bb3c[RS:XagUS- S- nUR5(dg/nSnURS5HnUR 5(dUR 5(dM0UR S5nURS5S :wa SSS5 McSSS5 UR5owRnUS -(aMUn US -(aU S -n US -(aU S-n US-(aU S-n U S -(dU S -n [R"XY5 US- nM U(aWUS3U(aS[U5S3OS-n URSS5 U(a UR O UR""SU 5 gU(a[$R'SUS35 U(a7[$R'S5 UHn[$R'SU35 M gg!,(df  GNP=f![a GMf=f![a1n URURU5SU 35 Sn A GMSn A ff=f)zcEnsure POSIX .sh scripts under .specify/scripts (recursively) have execute bits (no-op on Windows).ntNz.specifyscriptsrz*.shrbrfs#!I@ rhrez: z updated, z failedrchmodz"Set script permissions recursivelyz%[cyan]Updated execute permissions on z script(s) recursively[/cyan]z3[yellow]Some scripts could not be updated:[/yellow]r)rrDr0r is_symlinkr'rNreadrstatst_moderr<rrrrlrrr) r3r" scripts_rootfailuresupdatedscriptrWstmodenew_moderr~s rensure_executable_scriptsrs ww$*,y8L    HG$$V, H  ""&..*:*: [[&!vvayE) '&)' Bzze|He|X.Xe|X.Xe|X.Xu$E! HHV & qLG)-.9H%2c(m_G)DVXY GAB"(8(8 8'6J  MMA'Jgh i  MMO P QCj) 3'&   H OOv11,?@1#F G G Hsm *H:H G6"H-H5%HAH6 H HHH HHHH I$%IIz`Name for your new project directory (optional if using --here, or use '.' for current directory))rz--aizAI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, shai, q, bob, or qoder z--scriptzScript type to use: sh or psz--ignore-agent-toolsz/Skip checks for AI agent tools like Claude Codez--no-gitz"Skip git repository initializationz--herezIInitialize project in the current directory instead of creating a new onez--forcez;Force merge/overwrite when using --here (skip confirmation)z --skip-tlsz+Skip SSL/TLS verification (not recommended)z--debugzBShow verbose diagnostic output for network and extraction failuresz--github-tokenz[GitHub token to use for API requests (or set GH_TOKEN or GITHUB_TOKEN environment variable) project_nameignore_agent_toolsno_githereforceskip_tlsc 2^1^2[5 US:XaSnSnU(a2U(a+[RS5 [R"S5eU(d2U(d+[RS5 [R"S5eU(a[ R "5Rn[ R "5n [U R55n U (a[RS[U 5S35 [RS 5 U(a[RS 5 O[R"S 5n U (d+[RS 5 [R"S 5eO}[ U5R5n U R5(aO[SUS3SSSS9n [R5 [RU 5 [R"S5e[ R "5nSSSSSU RS3SSSUS3/nU(dURSSSU S35 [R[SR!U5SSS 95 S!nU(d'[#S"5nU(d[RS#5 U(a_U[$;aR[RS$US%S&R![$R'5535 [R"S5eUnO:[$R)5VVs0sH unnUUS'_M nnn[+US(S)5nU(d[$R-U5nU(awUS*(amUS+n[#U5(dX[S,US-US.US'S/3S0SSS9n [R5 [RU 5 [R"S5eU(a_U[.;aR[RS1US%S&R![.R'5535 [R"S5eUnOO[0RS2:XaS3OS4n[2R4R75(a[+[.S5U5nOUn[RS6U35 [RS7U35 [9S85m2S[2lT2R=S9S:5 T2R?S9S;5 T2R=SS?5 T2R?S>U5 S@HunnT2R=UU5 M Sn[AT2RC5[SASSB9m1T2REU1U24SCj5 U(+nU(a[FOS!n[HRJ"USD9n[MU UUUS!T2UXSE9 [OU T2SF9 U(dT2RQS"5 [SU 5(aT2R?S"SG5 OhU(a<[UU SSH9unnU(aT2R?S"SI5 O:T2RWS"SJ5 UnO%T2RYS"SK5 OT2RYS"SL5 T2R?SMSN5 SSS5 [RT2RC55 [RSZ5 U(aE[R5 [S[US\U(dU OSS]3S^SSS9n&[RU&5 [$R-U5nU(a>US_n'[S`U'Sa3SbScSS9n([R5 [RU(5 /n)U(dU)RSdUSe35 Sfn*OU)RSg5 Sfn*USh:Xa_U Si- n+[lRn"[]U+55n,[0RS2:XaSjU,3n-OSkU,3n-U)RU*SlU-Se35 U*S- n*U)RU*Sm35 U)RSn5 U)RSo5 U)RSp5 U)RSq5 U)RSr5 [SR!U)5SsSSS9n.[R5 [RU.5 StSSuSvSw/n/[SR!U/5SxSSS9n0[R5 [RU05 gs snnf![ZGaVn T2RWSM[]U 55 [R[SOU 3SPSSQ95 U(aSR[2R^Ra5S 4SS[2Rb4ST[][ R "554/n![eSUU!55n"U!V#V$s/sHun#n$U#RgU"5SVU$SW3PM Os sn$n#fn%n#n$[R[SR!U%5SXSYSQ95 U(d+U R5(a[hRj"U 5 [R"S5eSn A ff=f!f=f!,(df  GN=f)ya  Initialize a new Specify project from the latest template. This command will: 1. Check that required tools are installed (git is optional) 2. Let you choose your AI assistant 3. Download the appropriate template from GitHub 4. Extract the template to a new project directory or current directory 5. Initialize a fresh git repository (if not --no-git and no existing repo) 6. Optionally set up AI assistant commands Examples: specify init my-project specify init my-project --ai claude specify init my-project --ai copilot --no-git specify init --ignore-agent-tools my-project specify init . --ai claude # Initialize in current directory specify init . # Initialize in current directory (interactive AI selection) specify init --here --ai claude # Alternative syntax for current directory specify init --here --ai codex specify init --here --ai codebuddy specify init --here specify init --here --force # Skip confirmation when current directory not empty r7TNzB[red]Error:[/red] Cannot specify both project name and --here flagrezg[red]Error:[/red] Must specify either a project name, use '.' for current directory, or use --here flagz:[yellow]Warning:[/yellow] Current directory is not empty (z items)ze[yellow]Template files will be merged with existing content and may overwrite existing files[/yellow]zN[cyan]--force supplied: skipping confirmation and proceeding with merge[/cyan]zDo you want to continue?z$[yellow]Operation cancelled[/yellow]rzDirectory '[cyan]z`[/cyan]' already exists Please choose a different project name or remove the existing directory.z[red]Directory Conflict[/red]r|rrz"[cyan]Specify Project Setup[/cyan]rProjectz<15z [green]z[/green]z Working Pathz [dim]z[/dim]z Target Pathr;r)rrFr.zD[yellow]Git not found - will skip repository initialization[/yellow]z([red]Error:[/red] Invalid AI assistant 'z'. Choose from: rrDzChoose your AI assistant:rCrGrFrz&[/cyan] not found Install from: [cyan]z[/cyan] zo is required to continue with this project type. Tip: Use [cyan]--ignore-agent-tools[/cyan] to skip this checkz [red]Agent Detection Error[/red]z'[red]Error:[/red] Invalid script type 'rr^r]z#Choose script type (or press Enter)z$[cyan]Selected AI assistant:[/cyan] z#[cyan]Selected script type:[/cyan] zInitialize Specify ProjectprecheckzCheck required toolsokz ai-selectzSelect AI assistantz script-selectzSelect script type) )rzFetch latest release)rr)rr)rzArchive contents)rzExtraction summary)rzEnsure scripts executable)rCleanup)r.zInitialize git repository)finalFinalizer)rrefresh_per_secondrcB>TRTR55$ru)rr)rr"srinit..ast{{7>>3C'Dr rrr"zexisting repo detected)r4 initializedz init failedzgit not availablez --no-git flagrz project readyzInitialization failed: Failurer}PythonPlatformCWDc3<# UHup[U5v M g7fru)r).0k_s r init..s"Ajda3q66jsu → [bright_black]rzDebug Environmentmagentaz( [bold green]Project ready.[/bold green]z@[yellow]Warning:[/yellow] Git repository initialization failed zB [dim]You can initialize git manually later with:[/dim] [cyan]cd z`[/cyan] [cyan]git init[/cyan] [cyan]git add .[/cyan] [cyan]git commit -m "Initial commit"[/cyan]z$[red]Git Initialization Failed[/red]rEzSome agents may store credentials, auth tokens, or other identifying and private artifacts in the agent folder within your project. Consider adding [cyan]z][/cyan] (or parts of it) to [cyan].gitignore[/cyan] to prevent accidental credential leakage.z&[yellow]Agent Folder Security[/yellow]rMz&1. Go to the project folder: [cyan]cd rrfz+1. You're already in the project directory!rMz.codexzsetx CODEX_HOME zexport CODEX_HOME=zO. Set [cyan]CODEX_HOME[/cyan] environment variable before running Codex: [cyan]z0. Start using slash commands with your AI agent:zD 2.1 [cyan]/speckit.constitution[/] - Establish project principlesz@ 2.2 [cyan]/speckit.specify[/] - Create baseline specificationz: 2.3 [cyan]/speckit.plan[/] - Create implementation planz: 2.4 [cyan]/speckit.tasks[/] - Generate actionable tasksz; 2.5 [cyan]/speckit.implement[/] - Execute implementationz Next StepszmOptional commands that you can use for your specs [bright_black](improve quality & confidence)[/bright_black]u○ [cyan]/speckit.clarify[/] [bright_black](optional)[/bright_black] - Ask structured questions to de-risk ambiguous areas before planning (run before [cyan]/speckit.plan[/] if used)u○ [cyan]/speckit.analyze[/] [bright_black](optional)[/bright_black] - Cross-artifact consistency & alignment report (after [cyan]/speckit.tasks[/], before [cyan]/speckit.implement[/])u○ [cyan]/speckit.checklist[/] [bright_black](optional)[/bright_black] - Generate quality checklists to validate requirements completeness, clarity, and consistency (after [cyan]/speckit.plan[/])zEnhancement Commands)8rrrrrrr/rDrrrconfirmresolver&rr<r>r+ AGENT_CONFIGrrarr0SCRIPT_TYPE_CHOICESrr stdinisattyra_specify_tracker_activerrr rrwrrrrrrr2r<rlrrrversionrplatformmaxljustr(rshlexquote)3rrorjrrrrrrmrnr3existing_itemsr error_panelr setup_linesshould_init_git selected_airyconfig ai_choices agent_configrFselected_scriptdefault_scriptrzgit_error_messagerlocal_ssl_context local_clientsuccessr;r _env_pairs _label_widthr v env_linesgit_error_panel agent_foldersecurity_notice steps_linesstep_num codex_path quoted_pathr steps_panelenhancement_linesenhancements_panelrr"s3 @@rr6r6s LMs   Z[jjm    Ajjm xxz xxz l2245  MMVWZ[iWjVkkrs t MMB C no ==)CDMM"HI**Q-'L)113    #L>2[[5" K MMO MM+ &**Q- ((*K - S/,"3"3!4H= # f[M8 K mC0|nFKL MM% +.VVTUO $U+ MM` a | + MMD\NRbcgclclmym~m~nAdBcCD E**Q- " >J=O=O=QR=Qkc6c6&>)=Q R(  '  #'' 4 L8&}5Kk**#[M*++6-y#F+,-TT=!&"   k*jjm# 1 1 MMCK=P`aeajajk~lDlDlFbGaHI J**Q- %!#Dd 99    01DFkm{|O,O MM8 FG MM77HIJ67G"&C KK 23 Z& KK 23 [[M3 KK!56 _o6  U  C  gnnAQU VZ^DE* !\F/5 5  < e];,5)LL(;< UO4   Wo 6" Y W\ MM'.."# MM=> P !",0 c:;< =9    o& ##K0L#H- %%1N3P Q:!     o&K CL>QXYZHIg!H, kk#j/2 77d?$[M2C&{m4ChZ'vwzv{|CD EA (#STU]^YZSTSTTU +.lQWafgK MMO MM+ x  B D O tyy):;CYhnx}~ MMO MM$%yS~ MM'3q6 * MM%"9! =Y]bc ds{{002156.C O, #"Aj"AA istisaeabde 566I!O\ist t eDIIi$8@SbklmL//11 l+**Q-  Y W VsK*d j%C9d i?)B.i:$g< ;A?i::i??jjj jc[5 [RS5 [S5nUR SS5 [ SUS9n0n[ R5HJup4USnUSnUR X55 U(a [ X0S9X#'M4URUS5 S X#'ML UR S S 5 [ S US9nUR S S 5 [ S US9n[RUR55 [RS5 U(d[RS5 [UR55(d[RS5 gg)z,Check that all required tools are installed.z-[bold]Checking for installed tools...[/bold] zCheck Available Toolsr.zGit version controlrrDrGzIDE-based, no CLI checkFcodezVisual Studio Codez code-insiderszVisual Studio Code Insidersz6 [bold green]Specify CLI is ready to use![/bold green]z5[dim]Tip: Install git for repository management[/dim]z?[dim]Tip: Install an AI assistant for the best experience[/dim]N) rrrrarr+rrarranyvalues) r"git_ok agent_results agent_keyr% agent_namerGcode_okcode_insiders_oks rrrs/M MMBC12G KK,- w /FM#/#5#5#7 !&) #N3  I* '1)'MM $ LL$= >',M $$8 KK,-1G KK!>?!/7C MM'.."# MMKL  MN }##% & & WX 'r c,SSKnSSKn[5 SnURR S5nS nS nS US US 3n Sn Sn [RU SS[5S9n U R S:XaU R#5n U RSS5n U R%S5(aU SSn U RSS5n U S:wa8[&R("U R+SS55nUR-S5n [/SSSS9nUR1SSSS9 UR1S S!S"9 UR3S#U5 UR3S$U 5 UR3S%U 5 UR3S&S&5 UR3S'UR555 UR3S(UR755 UR3S)UR955 UR3S*UR 55 [;US+SS,S-9n[<R?U5 [<R?5 g![ a SSKn[[5RRRS- nUR5(a_[US5nURU5nURS05RSS5nSSS5 GM!,(df  GN=fGN![ a GNf=ff=f![ a GNf=f![ a GNf=f).z'Display version and system information.rNunknownz specify-clizpyproject.tomlrprojectrrrrsrtrurv Trxr{rr.re published_atZz+00:00z%Y-%m-%dFr) show_headerboxrKeyrrightrValuerrz CLI VersionzTemplate VersionReleasedrrr Architecturez OS Versionz.[bold cyan]Specify CLI Information[/bold cyan]rr) rimportlib.metadatarrrrtomllibr__file__rr&rNrPr0rlr$r8rO startswithr fromisoformatreplacer=rrrpython_versionsystemmachinerrr)r importlib cli_versionrRpyproject_pathrWdatarrrtemplate_version release_daterrdt info_tablepanels rrrsMK ((00? JI-j\9+EUVG L :: !(*     3 &#==?L+// IF **3//#3AB#7 '++NIFLy(!// 0D0DS(0STB#%;;z#:L 5dFCJ%vw?'1}k2)+;<z<0r2x!8!8!:;z8??#45~x'7'7'9:|X%5%5%78 >  E MM% MMOC    !(^2299@@CSSN$$&&.$/1"<<?D"&((9b"9"="=i"SK0///'    N!    syH(BL7K4( K13AK4K<K K KK K-(K1,K--K14 L>LLL LLc[5 gru)apprr rmainreTsEr __main__ru)zSelect an optionN)TFF)F)FN)rN)Yrrrr rrr(rrOpathlibrtypingrrrr rich.consoler rich.panelr rich.progressrr r rich.textr rich.liver rich.alignr rich.tabler rich.treer typer.corerrssl truststorerr SSLContextPROTOCOL_TLS_CLIENTrrrlrrrcr$Headersr7r1rBrrhomer%rrrarrrrTyperrdrrContextrboolr r+r2r<rZrQrrrcommandArgumentOptionr6rrrerrr rr~s    " ==! '##C$;$;< [ )eS4Ze3:eAC$JA$A u}}8# CTW, ?gJ 8 KgV Wgb cgn Y ogz5 {gF . GgR   Sg^(S  _gj ;  kgv 4  wgB   Cg R6\JIIK)+g5@  >SSj(II3IZ]IilIV ),*, kk  B  %--T#YdDY]jrsvjw$S;$>dd(!!T!eD(SV-DW>X!F*0)D)t)d)W[)V`duyRVosCH^bpp4pY\pnrpKOp`e`l`lp|@pX[pglmqswmwgxpdSMQquNRbg}ASSCSVYSkoSFJS\gjn\nSDKKS[_SwzSFJSl**D**;;M**Y]**Xt3UV T69QR||D*;YZ$||E3IQB C<<z8\]eX4A,,ui6st\\%